{"_id":"@convivainc/conviva-js-replay","_rev":"5-90a584823ae87de09e20c0996f5d794a","name":"@convivainc/conviva-js-replay","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@convivainc/conviva-js-replay","version":"1.0.0","keywords":["Conviva","Application","Analytics","Replay"],"author":{"name":"Conviva Inc"},"license":"MIT","_id":"@convivainc/conviva-js-replay@1.0.0","maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"mpfeiffer@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"homepage":"https://github.com/Conviva/conviva-js-replay#readme","bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"dist":{"shasum":"92f60907f054037006337041a77b8d3b34f28a79","tarball":"https://registry.npmjs.org/@convivainc/conviva-js-replay/-/conviva-js-replay-1.0.0.tgz","fileCount":6,"integrity":"sha512-AeJL+sI6B/IAZ6yYTWVvO+Rwp8ZYTwqEVFKaQ8lEgAp8St1gxrwgNH1fh349M/8CyFKDatLmL2V5vgDx30Y7BQ==","signatures":[{"sig":"MEYCIQCZBSCt2qHnAffqzkEPHDW0KbaSevcHIsMtqovp3/FJngIhAKm3iDV9ToODIrlAW6KsUWm48x6F60O+EseeqcD4Gp6r","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":343303},"main":"conviva-replay.umd.min.js","types":"conviva-replay.umd.d.ts","gitHead":"0984a682b4f1041e2889590474a4588676088af3","_npmUser":{"name":"diptiman","email":"dmukherjee@conviva.com"},"repository":{"url":"git+github.com:Conviva/conviva-js-replay.git","type":"git"},"_npmVersion":"8.11.0","description":"Conviva Replay library","directories":{},"_nodeVersion":"16.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/conviva-js-replay_1.0.0_1766151173466_0.8550668182178014","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@convivainc/conviva-js-replay","version":"1.0.1","keywords":["Conviva","Application","Analytics","Replay"],"author":{"name":"Conviva Inc"},"license":"MIT","_id":"@convivainc/conviva-js-replay@1.0.1","maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"it@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"homepage":"https://github.com/Conviva/conviva-js-replay#readme","bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"dist":{"shasum":"bd28b74e4ed072f9e334458eaebef69c5a751091","tarball":"https://registry.npmjs.org/@convivainc/conviva-js-replay/-/conviva-js-replay-1.0.1.tgz","fileCount":6,"integrity":"sha512-H3z2AjQuU6kjlMsYKa+HjvTTPkdfVyDYxv/I+AWoVwII/xoTL4MjCt7NV1QAgXSxMxue94nVGFRDSm6E6qeA5Q==","signatures":[{"sig":"MEQCIGNf8OXU8BbslrZ4FE9Uipt62mgDo+Jgeq83FcAdQaBOAiBhf38Z+KspZn7uSKT81MULr5YIijfEktTqXG4Qv4+MPQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":349852},"main":"conviva-replay.umd.min.js","types":"conviva-replay.umd.d.ts","gitHead":"b9330fc61fe7c495d9235a4afb2c363d9b90b370","_npmUser":{"name":"diptiman","email":"dmukherjee@conviva.com"},"repository":{"url":"git+github.com:Conviva/conviva-js-replay.git","type":"git"},"_npmVersion":"8.11.0","description":"Conviva Replay library","directories":{},"_nodeVersion":"16.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/conviva-js-replay_1.0.1_1769604915642_0.8314367078713218","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@convivainc/conviva-js-replay","version":"1.0.2","keywords":["Conviva","Application","Analytics","Replay"],"author":{"name":"Conviva Inc"},"license":"MIT","_id":"@convivainc/conviva-js-replay@1.0.2","maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"it@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"homepage":"https://github.com/Conviva/conviva-js-replay#readme","bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"dist":{"shasum":"4412e7a90479a2d43f342569fecd2dc8edb3caa3","tarball":"https://registry.npmjs.org/@convivainc/conviva-js-replay/-/conviva-js-replay-1.0.2.tgz","fileCount":7,"integrity":"sha512-qJ30xx5OPv32NnmVfBsNkRmLTqZB5q0qohUN1gXMvA2jT6Qhs9vAsQUJXUGXx/IGGVjuLPTMwIhp3GUuxWTvWQ==","signatures":[{"sig":"MEYCIQDOwygypriV6rHn6330Y+hlYtEKksnLnW8wE6wchbkQugIhAMlSC/jrYClFQJYg2+FVEztvVPjHKuOB4oAB6gfZgPdP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":356769},"main":"conviva-replay.umd.min.js","types":"conviva-replay.umd.d.ts","gitHead":"135e3deeab7d67b84ae2c389f8090c620598ee22","_npmUser":{"name":"mknath7","email":"kmarsada@conviva.com"},"repository":{"url":"git+github.com:Conviva/conviva-js-replay.git","type":"git"},"_npmVersion":"11.11.0","description":"Conviva Replay library","directories":{},"_nodeVersion":"22.13.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/conviva-js-replay_1.0.2_1773731215421_0.2507791002870856","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@convivainc/conviva-js-replay","version":"1.0.3","keywords":["Conviva","Application","Analytics","Replay"],"author":{"name":"Conviva Inc"},"license":"MIT","_id":"@convivainc/conviva-js-replay@1.0.3","maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"it@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"homepage":"https://github.com/Conviva/conviva-js-replay#readme","bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"dist":{"shasum":"719fa74c7e370b4e7e79ea1f2a2691ebd834d79b","tarball":"https://registry.npmjs.org/@convivainc/conviva-js-replay/-/conviva-js-replay-1.0.3.tgz","fileCount":7,"integrity":"sha512-FCVM9SsENYdtjZ1OF1Zop2XdaEvLQgK2wHCaYPyYegtIF2KBw0k1azd8L2ZVfkTiM0wMJyLyj79jr1a8mCHLxA==","signatures":[{"sig":"MEQCICYLGscXf61h13Mb6r9mdSU0r4f/+vb29uqHU21Uk6bWAiBAIHN9nI5K/D8Ja0hst3HEczRQoziISCvwEBRphwvHEw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357873},"main":"conviva-replay.umd.min.js","types":"conviva-replay.umd.d.ts","gitHead":"c6220ace841fb5993dac3b82662bd33a0826b0e7","_npmUser":{"name":"diptiman","email":"dmukherjee@conviva.com"},"repository":{"url":"git+github.com:Conviva/conviva-js-replay.git","type":"git"},"_npmVersion":"8.11.0","description":"Conviva Replay library","directories":{},"_nodeVersion":"16.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/conviva-js-replay_1.0.3_1774996278838_0.6237458019499855","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@convivainc/conviva-js-replay","version":"1.0.4","description":"Conviva Replay library","main":"conviva-replay.umd.min.js","types":"conviva-replay.umd.d.ts","repository":{"type":"git","url":"git+github.com:Conviva/conviva-js-replay.git"},"keywords":["Conviva","Application","Analytics","Replay"],"author":{"name":"Conviva Inc"},"license":"MIT","bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"homepage":"https://github.com/Conviva/conviva-js-replay#readme","gitHead":"6c76833027de708adfff816c7d2e49857a5ecabe","_id":"@convivainc/conviva-js-replay@1.0.4","_nodeVersion":"16.20.0","_npmVersion":"8.19.4","dist":{"integrity":"sha512-syPxf2HHVqvXTYVGXUxNfpbuyj61Dz5jEyEDt8JdYrekbqJHGlWltaCpWETi46hauqZBUGl32uPLeQdDfAlOpw==","shasum":"f096c40e534359e4415530cde74818e43efa2160","tarball":"https://registry.npmjs.org/@convivainc/conviva-js-replay/-/conviva-js-replay-1.0.4.tgz","fileCount":7,"unpackedSize":363480,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDCsIEQo1gKiQftG+4jH3EFo24J1+eaKfv3/hjMuhcJAAIgP5zw4zSvSyfm8GGCLJD0rZ8MQ6lPEmbBlbwnQNVS3Qs="}]},"_npmUser":{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},"directories":{},"maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"it@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/conviva-js-replay_1.0.4_1779617808824_0.07743644141963868"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-19T13:32:53.359Z","modified":"2026-05-24T10:16:49.220Z","1.0.0":"2025-12-19T13:32:53.647Z","1.0.1":"2026-01-28T12:55:15.833Z","1.0.2":"2026-03-17T07:06:55.565Z","1.0.3":"2026-03-31T22:31:19.098Z","1.0.4":"2026-05-24T10:16:48.979Z"},"bugs":{"url":"https://github.com/Conviva/conviva-js-replay/issues"},"author":{"name":"Conviva Inc"},"license":"MIT","homepage":"https://github.com/Conviva/conviva-js-replay#readme","keywords":["Conviva","Application","Analytics","Replay"],"repository":{"type":"git","url":"git+github.com:Conviva/conviva-js-replay.git"},"description":"Conviva Replay library","maintainers":[{"name":"sarathramachandra","email":"sramachandra@conviva.com"},{"name":"conviva_npm","email":"it@conviva.com"},{"name":"mrastogi-conviva","email":"mrastogi@conviva.com"},{"name":"mknath7","email":"kmarsada@conviva.com"},{"name":"shansmuhammad","email":"mshan@conviva.com"},{"name":"convivadev","email":"bpeddi@conviva.com"},{"name":"sandeepmadineni","email":"smadine@conviva.com"},{"name":"spspura","email":"sps@conviva.com"},{"name":"sunilkumar.gc","email":"sgc@conviva.com"},{"name":"diptiman","email":"dmukherjee@conviva.com"}],"readme":"# Conviva Replay\n\nA standalone replay module for Conviva analytics that works with both npm and script tags.\n\n> **Compatibility:** Replay **v1.0.4 or later** is required when using `@convivainc/conviva-js-appanalytics` (or its script-tag variant) **v2.2.0 or later**. Earlier replay versions will not react to DPI's mid-session clientId changes and the replay session will be detached from the DPI session.\n\n## Installation\n\n### NPM\n```bash\nnpm install @convivainc/conviva-js-replay\n```\n\n### Script Tag\nConviva hosts sensor scripts on its CDN, allowing direct integration via <script> tags without needing a package manager. The CDN URLs follow the pattern below, where the version segment (e.g., v1.0.0, v1.0.1) should be replaced with the desired sensor version:\n\nTo use them, add a script tag to your HTML before DPI SDK intialization:\n\n```js\n<script src=\"https://sensor.conviva.com/replay/releases/v1.0.1/conviva-replay.umd.min.js\"></script>\n```\n\nConviva's CDN supports Brotli and gzip compression. When the browser sends the appropriate Accept-Encoding header (which modern browsers do by default), the CDN automatically serves a compressed response, reducing download size and improving load times with no additional configuration required.\n\n**Note**: Conviva CDN serves replay packages starting from version v1.0.1\n\n## Usage\n\n### NPM/ES Modules\n\n#### Simple Usage (Recommended)\n```typescript\nimport { init } from '@convivainc/conviva-js-replay';\n\n// Just provide your customer key - that's it!\ninit('CONVIVA_ACCOUNT_CUSTOMER_KEY');\n// INITIALISE CONVIVA-JS-APPP-ANALYTICS(https://github.com/Conviva/conviva-js-appanalytics) AFTER COHORT REPLAY INITIALISATION\n```\n\n### Script Tag\n\n#### Simple Usage (Recommended)\n```html\n<script src= \"<<URL / Path to conviva-replay.umd.min.js>>\"></script>\n<script>\n  // Just provide your customer key - that's it!\n  ConvivaReplay.init('CONVIVA_ACCOUNT_CUSTOMER_KEY');\n  // INITIALISE CONVIVA-JS-SCRIPT-APPP-ANALYTICS(https://github.com/Conviva/conviva-js-script-appanalytics) AFTER COHORT REPLAY INITIALISATION\n</script>\n```\n\n## API Reference\n\n### Functions\n\n#### `init(customerKey)`\n**Recommended method** - Simple initialization with just a customer key.\n\n**Parameters:**\n- `customerKey` (string): Your Conviva customer key\n\n**Example:**\n```typescript\n// Simple usage\ninit('CONVIVA_ACCOUNT_CUSTOMER_KEY');\n```\n\n## Important configurations\n\n### Content Security Policy (CSP): allow Web Workers (Blob)\nSome environments enforce a strict Content Security Policy (CSP). The SDK uses a Web Worker created from a blob: URL, which requires explicitly allowing workers.\nAdd the following directive to your site’s Content-Security-Policy:\n```typescript\nContent-Security-Policy: worker-src 'self' blob:;\n```\n**Notes**\n1. If your policy already includes worker-src, extend it to include blob:.\n2. If worker-src is not defined, browsers may fall back to script-src, which can prevent worker creation.\n\n### CORS: allow loading required external assets (CSS/SVG)\nOn many websites, required assets (commonly CSS files or SVGs) may be hosted on a different origin (domain/subdomain). If those assets are blocked by cross-origin restrictions, configure the hosting server/CDN to allow cross-origin access.\nEnsure the asset server returns appropriate CORS response headers, such as:\n```typescript\nAccess-Control-Allow-Origin: https://pulse.conviva.com\n// If the host changes or a new host is introduced in the future, it should be allowed as well.\n```\nOr, if your security policy allows it:\n```typescript\nAccess-Control-Allow-Origin: *\n```\n\n## Limitation\n\n### Replay availability after tab close\nIf a user closes the browser tab after performing an activity, the last up to 1 minute of user activity per origin may not be available immediately.\nThis duration represents the maximum possible gap; in most cases, the unavailable replay segment will be less than 1 minute.\nReplay data for that origin will resume only after the application is relaunched and the user returns to the same origin.\n\n**Notes**\n1. This limitation applies on a per-origin basis.\n2. Once the user revisits the same origin, replay capture and availability continue as expected.\n","readmeFilename":"README.md"}