feat: add esign package to monorepo

.github/workflows/ci-esign.yml

@@ -0,0 +1,45 @@
+name: CI eSign
+
+permissions:
+  contents: read
+
+on:
+  pull_request:
+    paths:
+      - 'packages/esign/**'
+  workflow_dispatch:
+
+concurrency:
+  group: ci-esign-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build superdoc (dependency)
+        run: pnpm run build:superdoc
+
+      - name: Lint
+        run: pnpm --filter @superdoc-dev/esign lint
+
+      - name: Type check
+        run: pnpm --filter @superdoc-dev/esign type-check
+
+      - name: Build
+        run: pnpm --filter @superdoc-dev/esign build
+
+      - name: Test
+        run: pnpm --filter @superdoc-dev/esign test

.github/workflows/ci-superdoc.yml

@@ -9,6 +9,7 @@ on:
     paths-ignore:
       - 'apps/docs/**'
       - 'packages/template-builder/**'
+      - 'packages/esign/**'
       - '**/*.md'
 
 concurrency:

.github/workflows/deploy-demos.yml

@@ -5,7 +5,7 @@ on:
     branches: [main]
     paths:
       - 'packages/template-builder/**'
-      # Add more demo paths here as needed
+      - 'packages/esign/**'
   workflow_dispatch:
 
 jobs:
@@ -30,7 +30,25 @@ jobs:
           publish_dir: ./packages/template-builder/demo/dist
           cname: template-builder.superdoc.dev
 
-  # Add more demo deploy jobs here as needed
-  # deploy-another-demo:
-  #   runs-on: ubuntu-latest
-  #   steps: ...
+  deploy-esign-demo:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - run: pnpm install
+      - name: Build superdoc (dependency)
+        run: pnpm run build:superdoc
+      - name: Build esign
+        run: pnpm --filter @superdoc-dev/esign build
+      - name: Build demo
+        run: pnpm --filter superdoc-esign-demo build
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./packages/esign/demo/dist
+          cname: esign.superdoc.dev

.github/workflows/deploy-esign-proxy.yml

@@ -0,0 +1,68 @@
+name: Deploy eSign Proxy Server
+
+on:
+  workflow_dispatch:
+
+env:
+  PROJECT_ID: ${{ vars.GCP_PROJECT_ID }}
+  REGION: ${{ vars.GCP_REGION }}
+  SERVICE_NAME: esign-demo-proxy-server
+  SUPERDOC_SERVICES_BASE_URL: ${{ vars.SUPERDOC_SERVICES_BASE_URL }}
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Auth to Google Cloud
+        uses: google-github-actions/auth@v2
+        with:
+          credentials_json: ${{ secrets.GCP_SA_KEY }}
+
+      - name: Setup gcloud
+        uses: google-github-actions/setup-gcloud@v2
+        with:
+          project_id: ${{ env.PROJECT_ID }}
+
+      - name: Build and push container with Cloud Build
+        run: |
+          REGION="${REGION:-us-central1}"
+          SERVICE_NAME="${SERVICE_NAME:-esign-demo-proxy-server}"
+          IMAGE="gcr.io/${PROJECT_ID}/${SERVICE_NAME}:${GITHUB_SHA}"
+
+          echo "REGION=${REGION}" >> $GITHUB_ENV
+          echo "SERVICE_NAME=${SERVICE_NAME}" >> $GITHUB_ENV
+          echo "IMAGE=${IMAGE}" >> $GITHUB_ENV
+
+          gcloud builds submit packages/esign/demo/server --tag "${IMAGE}"
+        env:
+          PROJECT_ID: ${{ env.PROJECT_ID }}
+          REGION: ${{ env.REGION }}
+          SERVICE_NAME: ${{ env.SERVICE_NAME }}
+
+      - name: Deploy container to Cloud Run
+        run: |
+          REGION="${REGION:-us-central1}"
+          SERVICE_NAME="${SERVICE_NAME:-esign-demo-proxy-server}"
+          IMAGE="${IMAGE}"
+          SUPERDOC_SERVICES_BASE_URL="${SUPERDOC_SERVICES_BASE_URL:-https://api.superdoc.dev}"
+
+          gcloud run deploy "${SERVICE_NAME}" \
+            --image "${IMAGE}" \
+            --region "${REGION}" \
+            --memory=1Gi \
+            --cpu=1 \
+            --allow-unauthenticated \
+            --set-env-vars SUPERDOC_SERVICES_BASE_URL="${SUPERDOC_SERVICES_BASE_URL}" \
+            --set-secrets="SUPERDOC_SERVICES_API_KEY=esign-demo-sd-services-api-key:latest"
+        env:
+          IMAGE: ${{ env.IMAGE }}
+          REGION: ${{ env.REGION }}
+          SERVICE_NAME: ${{ env.SERVICE_NAME }}
+          SUPERDOC_SERVICES_BASE_URL: ${{ env.SUPERDOC_SERVICES_BASE_URL }}

.github/workflows/release.yml

@@ -82,6 +82,14 @@ jobs:
         working-directory: packages/template-builder
         run: pnpx semantic-release
 
+      - name: Release esign
+        env:
+          GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        working-directory: packages/esign
+        run: pnpx semantic-release
+
       # Sync stable back to main after stable release
       # - name: Sync stable to main
       #   if: github.ref == 'refs/heads/stable'

packages/esign/.gitignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+
+# Build
+dist/
+
+# Logs
+*.log
+npm-debug.log*
+
+# Editor
+.vscode/
+.DS_Store
+
+# Environment
+.env
+
+# Coverage
+coverage/
+
+# Examples
+examples/**/package-lock.json
+examples/**/pnpm-lock.yaml
+examples/**/yarn.lock
+
+# Dev
+dev/**
+CLAUDE.md
+/demo-crc

packages/esign/.releaserc.cjs

@@ -0,0 +1,34 @@
+/* eslint-env node */
+const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
+
+const config = {
+  branches: [
+    { name: 'stable', channel: 'latest' },
+    { name: 'main', prerelease: 'next', channel: 'next' },
+  ],
+  tagFormat: 'esign-v${version}',
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    ['@semantic-release/npm', { npmPublish: true }],
+  ],
+};
+
+const isPrerelease = config.branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease
+);
+
+if (!isPrerelease) {
+  config.plugins.push([
+    '@semantic-release/git',
+    {
+      assets: ['package.json'],
+      message:
+        'chore(esign): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+    },
+  ]);
+}
+
+config.plugins.push('@semantic-release/github');
+
+module.exports = config;

packages/esign/CHANGELOG.md

@@ -0,0 +1,74 @@
+# [1.3.0](https://github.com/superdoc-dev/esign/compare/v1.2.0...v1.3.0) (2025-10-08)
+
+
+### Features
+
+* enhance document download and UI components in app ([#1](https://github.com/superdoc-dev/esign/issues/1)) ([cab8848](https://github.com/superdoc-dev/esign/commit/cab8848b70a86453ed323413086d05dcb614d32b))
+* integrate testing framework and add test cases ([#2](https://github.com/superdoc-dev/esign/issues/2)) ([e92c73e](https://github.com/superdoc-dev/esign/commit/e92c73eab838be19c624c72289446caf38264885))
+
+# [1.2.0](https://github.com/superdoc-dev/esign/compare/v1.1.2...v1.2.0) (2025-10-07)
+
+
+### Features
+
+* add download functionality for document conversion in App component ([69a9403](https://github.com/superdoc-dev/esign/commit/69a94039d52f1f1249f66f4a8881be3a83ba86c1))
+
+## [1.1.2](https://github.com/superdoc-dev/esign/compare/v1.1.1...v1.1.2) (2025-10-07)
+
+
+### Bug Fixes
+
+* modify README to reflect changes in document source and field values ([7b904ee](https://github.com/superdoc-dev/esign/commit/7b904ee4cd642bbf847980fede5e0ac8a9260adf))
+* remove unused superdoc CSS import from index.tsx ([d17f61f](https://github.com/superdoc-dev/esign/commit/d17f61f9437b85e90b68b218c796d7b97466bb6f))
+* simplify rollup external dependencies and add superdoc styles ([0c0be96](https://github.com/superdoc-dev/esign/commit/0c0be96693afc2d10df9ffff8fcbc5c9838c9ad5))
+
+## [1.1.1](https://github.com/superdoc-dev/esign/compare/v1.1.0...v1.1.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* update package.json to include dependencies and fix README installation command ([722321b](https://github.com/superdoc-dev/esign/commit/722321bcbee9ebdaf2c481328c59cc16e105a96d))
+
+# [1.1.0](https://github.com/superdoc-dev/esign/compare/v1.0.1...v1.1.0) (2025-10-07)
+
+
+### Bug Fixes
+
+* update @types/react and @types/react-dom to latest versions ([68cf44c](https://github.com/superdoc-dev/esign/commit/68cf44cdfdb5cc21365304b688c6abb01a830837))
+* update license to AGPL-3.0 and fix workflow for syncing stable releases to main ([b0a60d0](https://github.com/superdoc-dev/esign/commit/b0a60d028730a974c3b708192aec2ac38c5fa0fc))
+
+
+### Features
+
+* add GitHub Actions workflow to sync patches to main branch ([af02010](https://github.com/superdoc-dev/esign/commit/af02010619ba804efdf7ae4a2c4f5a63de96f720))
+
+## [1.0.1](https://github.com/superdoc-dev/esign/compare/v1.0.0...v1.0.1) (2025-10-07)
+
+
+### Bug Fixes
+
+* update superdoc version and refactor consent handling ([afe3e18](https://github.com/superdoc-dev/esign/commit/afe3e18a5b101b2fae8bb4e93752c63a10f332ad))
+
+# 1.0.0 (2025-10-07)
+
+
+### Bug Fixes
+
+* add superdoc class and data attribute to eSign component ([a9ce117](https://github.com/superdoc-dev/esign/commit/a9ce1171d3f4fb457b2d5f53cb0e3fc82c8806f4))
+* trigger release ([c02a107](https://github.com/superdoc-dev/esign/commit/c02a107749b83b7731bcd19634c5d72ca23b7f92))
+* trigger release ([73e3580](https://github.com/superdoc-dev/esign/commit/73e3580cea43d02eb0fd327c7b1930725d26f209))
+* trigger release ([841ec15](https://github.com/superdoc-dev/esign/commit/841ec1502286c0cc454e17309fca55f2b39cb79b))
+
+
+### Features
+
+* add additional fields for user information in App component ([038a5dd](https://github.com/superdoc-dev/esign/commit/038a5dd97f3761a5713ec621553d7cf67568edbb))
+* add GitHub Actions workflow for demo deployment and Vite configuration for demo and examples ([1b52830](https://github.com/superdoc-dev/esign/commit/1b52830c00253e0a444c34e73c15ba7917b5cfe2))
+* add interactive demo for SuperDoc eSign with initial setup and styles ([4734e0f](https://github.com/superdoc-dev/esign/commit/4734e0f1daf7ea4d818f3334ec1eeea6803d3bd6))
+* add README and examples for SuperDoc eSign integration ([49c4477](https://github.com/superdoc-dev/esign/commit/49c4477f9c3f78b72ffcb280c544b2dadd69489c))
+* enhance ESLint configuration for React support and update package dependencies ([babacde](https://github.com/superdoc-dev/esign/commit/babacde252f6a55d2b3d0aed8ead8ec060a33a7a))
+* first commit ([d84a550](https://github.com/superdoc-dev/esign/commit/d84a5502c533615b2f619aed7b355876aec0ea00))
+* implement download functionality for document export in SuperDoc eSign ([1124775](https://github.com/superdoc-dev/esign/commit/11247759aa7050ba10e0ae9b869d68d180975ca0))
+* implement signature input handling and update document with signature image ([d31d5cc](https://github.com/superdoc-dev/esign/commit/d31d5cc60b4bd23d46fbd51d7e6b3cc8cb8f5df2))
+* implement signature input handling and update payload structure ([5c6ab23](https://github.com/superdoc-dev/esign/commit/5c6ab23885a052788cf23b61f540cabb2681c8a6))
+* trigger release ([f7f04ef](https://github.com/superdoc-dev/esign/commit/f7f04efffeccb9bf7240fcca9b6f8aaa2c482239))