@insure-os/client 0.0.3

package/NPM_PUBLISHING.md

@@ -0,0 +1,379 @@
+# NPM Publishing Guide
+
+Complete guide for publishing `@insure-os/scripts` to NPM registry.
+
+## 📦 Package Information
+
+- **Package Name**: `@insure-os/scripts`
+- **NPM Organization**: [@insure-os](https://www.npmjs.com/settings/insure-os/packages)
+- **Registry**: https://registry.npmjs.org/
+- **Access**: Public
+
+## 🚀 Quick Publish
+
+### Publish Everything (CDN + NPM)
+
+```bash
+pnpm release
+```
+
+This will:
+1. Bump patch version (0.0.0 → 0.0.1)
+2. Build production bundle
+3. Deploy to CDN (cdn.os.insure)
+4. Publish to NPM registry
+
+### Publish to NPM Only
+
+```bash
+# Build and publish
+pnpm release:npm
+
+# Or manually
+npm version patch
+pnpm build:prod
+pnpm publish:npm
+```
+
+### Publish to CDN Only
+
+```bash
+pnpm release:cdn
+```
+
+## 🔐 Authentication Setup
+
+### First Time Setup
+
+1. **Login to NPM** (if not already logged in):
+   ```bash
+   npm login
+   ```
+
+   Enter your NPM credentials:
+   - Username: (your NPM username)
+   - Password: (your NPM password)
+   - Email: (your email)
+   - 2FA code: (if enabled)
+
+2. **Verify you're a member of @insure-os org**:
+   ```bash
+   npm org ls insure-os
+   ```
+
+   You should see your username in the list.
+
+3. **Test authentication**:
+   ```bash
+   npm whoami
+   ```
+
+### Using NPM Access Tokens (CI/CD)
+
+For automated publishing in CI/CD:
+
+1. **Generate NPM token**:
+   - Go to https://www.npmjs.com/settings/YOUR_USERNAME/tokens
+   - Click "Generate New Token"
+   - Select "Automation" type
+   - Copy the token
+
+2. **Set environment variable**:
+   ```bash
+   export NPM_TOKEN=your_token_here
+   ```
+
+3. **Create `.npmrc` in CI**:
+   ```bash
+   echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
+   ```
+
+## 📋 Pre-Publish Checklist
+
+Before publishing, ensure:
+
+- [ ] All tests pass: `pnpm test`
+- [ ] Code is linted: `pnpm lint`
+- [ ] Types are valid: `pnpm typecheck`
+- [ ] Bundle builds successfully: `pnpm build:prod`
+- [ ] Bundle size is acceptable: `pnpm size:detailed`
+- [ ] README is up to date
+- [ ] CHANGELOG is updated (if you maintain one)
+- [ ] Version number is correct
+
+**Note**: The `prepublishOnly` script automatically runs `build:prod`, `test`, and `lint` before publishing.
+
+## 🧪 Dry Run (Test Publish)
+
+Always test before publishing:
+
+```bash
+pnpm publish:npm:dry
+```
+
+This will:
+- Show you what files will be published
+- Display package tarball contents
+- Validate package.json
+- **NOT** actually publish to NPM
+
+Review the output carefully!
+
+## 📦 What Gets Published
+
+The following files/folders are included in the NPM package:
+
+```
+@insure-os/scripts/
+├── dist/
+│   ├── index.esm.js       # ES Module
+│   ├── index.esm.js.map   # Source map
+│   ├── index.cjs          # CommonJS
+│   ├── index.cjs.map      # Source map
+│   ├── index.umd.js       # UMD (for CDN)
+│   ├── index.umd.js.map   # Source map
+│   └── index.d.ts         # TypeScript definitions
+├── README.md              # User documentation
+├── DEPLOYMENT.md          # Deployment guide
+├── CDN_SETUP.md           # CDN setup guide
+├── package.json
+└── LICENSE (if present)
+```
+
+**Excluded** (via .npmignore or package.json files field):
+- `src/` - Source code
+- `node_modules/`
+- `.env` - Credentials
+- Test files
+- Build configuration
+
+## 🔢 Version Management
+
+### Semantic Versioning
+
+Follow [semver](https://semver.org/):
+
+```bash
+npm version patch  # 0.0.1 → 0.0.2 (bug fixes)
+npm version minor  # 0.1.0 → 0.2.0 (new features, backwards compatible)
+npm version major  # 1.0.0 → 2.0.0 (breaking changes)
+```
+
+### Pre-release Versions
+
+For beta/alpha releases:
+
+```bash
+npm version prerelease --preid=beta  # 0.0.1 → 0.0.2-beta.0
+npm version prerelease --preid=alpha # 0.0.1 → 0.0.2-alpha.0
+```
+
+Publish with tag:
+
+```bash
+npm publish --tag beta
+npm publish --tag alpha
+```
+
+Users install with:
+
+```bash
+npm install @insure-os/scripts@beta
+npm install @insure-os/scripts@alpha
+```
+
+## 📊 After Publishing
+
+### Verify Publication
+
+1. **Check NPM registry**:
+   ```bash
+   npm view @insure-os/scripts
+   ```
+
+2. **Visit NPM page**:
+   https://www.npmjs.com/package/@insure-os/scripts
+
+3. **Test installation**:
+   ```bash
+   # In a test directory
+   mkdir test-install && cd test-install
+   npm init -y
+   npm install @insure-os/scripts
+   ```
+
+4. **Test import** (create `test.js`):
+   ```javascript
+   import { InsureOS } from '@insure-os/scripts';
+   console.log('InsureOS imported successfully:', InsureOS);
+   ```
+
+### Update Documentation
+
+After publishing a new version:
+
+1. Update any version-specific documentation
+2. Create a GitHub release (if using GitHub)
+3. Notify team/customers if needed
+4. Update CHANGELOG (if maintained)
+
+## 🚨 Troubleshooting
+
+### "You do not have permission to publish"
+
+**Problem**: Not a member of @insure-os org or not logged in.
+
+**Solution**:
+```bash
+# Login
+npm login
+
+# Verify membership
+npm org ls insure-os
+
+# Contact org owner to add you if not listed
+```
+
+### "Version X already exists"
+
+**Problem**: Trying to publish same version twice.
+
+**Solution**:
+```bash
+# Bump version first
+npm version patch
+
+# Then publish
+pnpm publish:npm
+```
+
+### "prepublishOnly script failed"
+
+**Problem**: Tests, build, or lint failed.
+
+**Solution**:
+```bash
+# Fix the issues
+pnpm test
+pnpm lint
+pnpm build:prod
+
+# Then try publishing again
+```
+
+### Package too large
+
+**Problem**: Package size exceeds limits.
+
+**Solution**:
+- Check what's being included: `pnpm publish:npm:dry`
+- Ensure `src/`, `node_modules/`, tests are excluded
+- Review `files` field in package.json
+
+## 📝 NPM Scripts Reference
+
+```bash
+# Publishing
+pnpm publish:npm          # Publish to NPM
+pnpm publish:npm:dry      # Dry run (test)
+pnpm publish:cdn          # Publish to CDN only
+pnpm release:npm          # Build + publish to NPM
+pnpm release:cdn          # Build + publish to CDN
+pnpm release:all          # Build + publish to both
+pnpm release              # Version + build + publish all
+
+# Version management
+npm version patch         # Bump patch version
+npm version minor         # Bump minor version
+npm version major         # Bump major version
+npm version prerelease    # Bump prerelease version
+
+# Pre-publish checks (run automatically)
+pnpm build:prod          # Build for production
+pnpm test                # Run tests
+pnpm lint                # Lint code
+pnpm typecheck           # Check TypeScript types
+
+# Verification
+pnpm size:detailed       # Check bundle sizes
+npm view @insure-os/scripts  # View published package
+```
+
+## 🔄 Complete Release Workflow
+
+### Standard Release (Patch)
+
+```bash
+# 1. Ensure clean working directory
+git status
+
+# 2. Pull latest changes
+git pull origin main
+
+# 3. Run all checks
+pnpm test
+pnpm lint
+pnpm build:prod
+
+# 4. Release (bumps version, builds, publishes to CDN + NPM)
+pnpm release
+
+# 5. Push version commit and tag
+git push origin main --tags
+
+# 6. Verify on NPM
+npm view @insure-os/scripts
+
+# 7. Test installation
+cd /tmp
+npm install @insure-os/scripts
+```
+
+### Manual Step-by-Step
+
+```bash
+# 1. Bump version
+npm version patch  # or minor/major
+
+# 2. Build
+pnpm build:prod
+
+# 3. Dry run to verify
+pnpm publish:npm:dry
+
+# 4. Publish to NPM
+pnpm publish:npm
+
+# 5. Publish to CDN
+pnpm publish:cdn
+
+# 6. Push to git
+git push origin main --tags
+```
+
+## 🔐 Security Best Practices
+
+1. **Never commit NPM tokens** to git
+2. **Use 2FA** on your NPM account
+3. **Rotate tokens** periodically
+4. **Review package contents** with dry-run before publishing
+5. **Use automation tokens** for CI/CD, not user tokens
+6. **Audit dependencies** regularly: `npm audit`
+
+## 📚 Related Documentation
+
+- [DEPLOYMENT.md](./DEPLOYMENT.md) - Quick deployment reference
+- [CDN_SETUP.md](./CDN_SETUP.md) - CDN configuration guide
+- [README.md](./README.md) - User-facing documentation
+- [NPM Documentation](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry)
+
+## 🆘 Getting Help
+
+- **NPM Support**: https://www.npmjs.com/support
+- **Check package status**: `npm view @insure-os/scripts`
+- **Organization settings**: https://www.npmjs.com/settings/insure-os/packages
+- **Team lead**: Contact for organization access issues
+
+---
+
+**Last Updated**: 2025-10-02

package/README.md

@@ -0,0 +1,299 @@
+# @insure-os/scripts
+
+A lightweight JavaScript client library for integrating InsureOS quote functionality into external websites. This library provides two simple integration methods: script tag with auto-initialization or NPM import with programmatic control.
+
+---
+
+## 🚀 Quick Start for Developers
+
+### Publishing to NPM + CDN
+
+```bash
+# Publish to both NPM and CDN in one command
+pnpm release
+```
+
+This will:
+1. Bump patch version (0.0.0 → 0.0.1)
+2. Build production bundles
+3. Deploy to CDN: `https://cdn.os.insure`
+4. Publish to NPM: `@insure-os/scripts`
+
+**NPM Package:**
+- Install: `npm install @insure-os/scripts`
+- View: https://www.npmjs.com/package/@insure-os/scripts
+
+**CDN URLs:**
+- Versioned: `https://cdn.os.insure/v{version}/insureos.min.js`
+- Major version: `https://cdn.os.insure/v{major}/insureos.min.js`
+- Latest: `https://cdn.os.insure/latest/insureos.min.js`
+
+📖 **Full guides:**
+- [DEPLOYMENT.md](./DEPLOYMENT.md) - Quick deployment reference
+- [NPM_PUBLISHING.md](./NPM_PUBLISHING.md) - NPM publishing guide
+- [CDN_SETUP.md](./CDN_SETUP.md) - CDN configuration
+- [DOCS_INDEX.md](./DOCS_INDEX.md) - All documentation
+
+---
+
+## Features
+
+- 🚀 **Simple Integration** - Two easy ways to integrate: script tag or NPM import
+- 🎯 **Auto-initialization** - Script tag automatically creates quote intents and renders buttons
+- 🎨 **Customizable Styling** - Well-named CSS classes for easy styling
+- 🔒 **Secure Authentication** - Built-in organization-based authentication
+- ⚡ **Lightweight** - Minimal bundle size with essential functionality only
+
+## Installation & Usage
+
+### Method 1: Script Tag (CDN - Recommended for external sites)
+
+Add a script tag from our CDN. This is the easiest way for external websites to integrate InsureOS.
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Insurance Quote</title>
+        <style>
+            /* Style the button with well-named CSS classes */
+            .insureos-submit-btn {
+                background-color: #007bff;
+                color: white;
+                border: none;
+                padding: 12px 24px;
+                font-size: 16px;
+                border-radius: 6px;
+                cursor: pointer;
+                font-family: system-ui, sans-serif;
+            }
+
+            .insureos-submit-btn:hover:not(:disabled) {
+                background-color: #0056b3;
+            }
+
+            .insureos-loading {
+                background-color: #6c757d;
+                cursor: not-allowed;
+            }
+
+            .insureos-error {
+                color: #dc3545;
+                padding: 12px;
+                border: 1px solid #dc3545;
+                border-radius: 4px;
+                background-color: #f8d7da;
+            }
+        </style>
+    </head>
+    <body>
+        <h1>Get Your Insurance Quote</h1>
+
+        <!-- Load InsureOS from CDN (use specific version for production) -->
+        <script
+            src="https://cdn.os.insure/v0.0.0/insureos.min.js"
+            integrity="sha384-x6rqyvqpRkF+stuy4Ydnp+gou2baQOQFXkfw7bt/NVtF2I0VJiXV8neu2iIDSLzf"
+            crossorigin="anonymous">
+        </script>
+
+        <script>
+            // Initialize InsureOS and mount to container
+            const client = new InsureOSScripts.InsureOS({
+                apiKey: 'your-api-key',
+                environment: 'production',
+            });
+
+            client.mount('#insureos-container', {
+                quoteIntentId: 'your-quote-intent-id',
+            });
+        </script>
+    </body>
+</html>
+```
+
+### Method 2: NPM Import with mount()
+
+Install the package and use the `InsureOS.mount()` method for programmatic control.
+
+```bash
+npm install @insure-os/scripts
+```
+
+```javascript
+import { InsureOS } from "@insure-os/scripts";
+
+// Mount to a specific DOM element
+const container = document.getElementById("quote-container");
+InsureOS.mount(container, {
+    orgId: "your-org-id",
+});
+```
+
+```html
+<!DOCTYPE html>
+<html>
+    <head>
+        <title>Insurance Quote</title>
+        <style>
+            .insureos-submit-btn {
+                background-color: #007bff;
+                color: white;
+                border: none;
+                padding: 12px 24px;
+                font-size: 16px;
+                border-radius: 6px;
+                cursor: pointer;
+            }
+        </style>
+    </head>
+    <body>
+        <h1>Get Your Insurance Quote</h1>
+        <div id="quote-container"></div>
+
+        <script type="module" src="./main.js"></script>
+    </body>
+</html>
+```
+
+## API Reference
+
+### InsureOS.mount()
+
+Mounts InsureOS quote functionality to a DOM element.
+
+```typescript
+InsureOS.mount(element: HTMLElement, config: MountConfig): Promise<void>
+```
+
+**Parameters:**
+
+- `element` - DOM element to mount the quote button to
+- `config` - Configuration object
+
+**MountConfig:**
+
+```typescript
+interface MountConfig {
+    orgId: string; // Required: Your organization ID
+    apiBaseUrl?: string; // Optional: Custom API base URL (defaults to https://api.os.insure)
+}
+```
+
+**Example:**
+
+```javascript
+import { InsureOS } from "@insure-os/scripts";
+
+// Basic usage
+InsureOS.mount(document.getElementById("quote-btn"), {
+    orgId: "123",
+});
+
+// With custom API URL (for development)
+InsureOS.mount(document.getElementById("quote-btn"), {
+    orgId: "123",
+    apiBaseUrl: "http://localhost:3000/dev",
+});
+```
+
+## How It Works
+
+1. **Initialization**: The library initializes with your organization ID
+2. **Quote Intent Creation**: Automatically creates a blank quote intent via API call
+3. **Button Rendering**: Renders a submit button with loading states
+4. **User Interaction**: When clicked, redirects user to the signed quote URL
+
+## CSS Classes for Styling
+
+The library uses well-named CSS classes that you can style:
+
+- `.insureos-submit-btn` - Main submit button
+- `.insureos-loading` - Loading state (added to button)
+- `.insureos-error` - Error message display
+
+## Examples
+
+### React Integration
+
+```jsx
+import React, { useEffect, useRef } from "react";
+import { InsureOS } from "@insure-os/scripts";
+
+function QuoteButton({ orgId }) {
+    const containerRef = useRef(null);
+
+    useEffect(() => {
+        if (containerRef.current) {
+            InsureOS.mount(containerRef.current, { orgId });
+        }
+    }, [orgId]);
+
+    return <div ref={containerRef} />;
+}
+```
+
+### Vue.js Integration
+
+```vue
+<template>
+    <div ref="quoteContainer"></div>
+</template>
+
+<script>
+import { InsureOS } from "@insure-os/scripts";
+
+export default {
+    props: ["orgId"],
+    mounted() {
+        InsureOS.mount(this.$refs.quoteContainer, {
+            orgId: this.orgId,
+        });
+    },
+};
+</script>
+```
+
+### Multiple Buttons
+
+```javascript
+import { InsureOS } from "@insure-os/scripts";
+
+// Mount multiple buttons for different organizations
+InsureOS.mount(document.getElementById("quote-1"), { orgId: "123" });
+InsureOS.mount(document.getElementById("quote-2"), { orgId: "456" });
+InsureOS.mount(document.getElementById("quote-3"), { orgId: "789" });
+```
+
+## Error Handling
+
+The library handles errors gracefully:
+
+- **Network errors**: Shows error message with retry capability
+- **API errors**: Displays user-friendly error messages
+- **Configuration errors**: Clear error messages for missing orgId
+
+Errors are displayed using the `.insureos-error` CSS class.
+
+## Browser Support
+
+- **Modern Browsers**: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
+- **Required Features**: Fetch API, Promises, ES2017 syntax
+
+## TypeScript Support
+
+Full TypeScript definitions are included:
+
+```typescript
+import { InsureOS, MountConfig, QuoteIntentResponse } from "@insure-os/scripts";
+
+const config: MountConfig = {
+    orgId: "your-org-id",
+    apiBaseUrl: "https://api.os.insure",
+};
+
+InsureOS.mount(element, config);
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

package/dist/bundle-sizes.json

@@ -0,0 +1,26 @@
+{
+  "timestamp": "2025-10-08T21:15:14.577Z",
+  "maxSizeKB": "1024.00",
+  "bundles": {
+    "es": {
+      "fileName": "index.esm.js",
+      "size": 280493,
+      "gzippedSize": 84396,
+      "sizeKB": "273.92",
+      "gzippedSizeKB": "82.42"
+    }
+  },
+  "summary": {
+    "totalBundles": 1,
+    "largestBundle": {
+      "format": "es",
+      "fileName": "index.esm.js",
+      "size": 280493,
+      "gzippedSize": 84396,
+      "sizeKB": "273.92",
+      "gzippedSizeKB": "82.42"
+    },
+    "totalSize": 280493,
+    "totalGzippedSize": 84396
+  }
+}