@privacyscrubber/sdk 2.3.6 → 2.3.7

package/README.md

@@ -145,6 +145,31 @@ console.log(restoredText);
 
 Drop-in sanitization for Next.js and Node.js applications built with the Vercel AI SDK (`ai`):
 
+#### 1-Liner Model Wrapper (generateText & streamText):
+```typescript
+import { streamText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { wrapAiModel } from '@privacyscrubber/sdk';
+
+// Wrap language model once: prompts are sanitized in RAM, responses de-tokenized on-the-fly
+const safeModel = wrapAiModel(openai('gpt-4o'), {
+    profile: 'Dev',
+    detectSecrets: true
+});
+
+export async function POST(req: Request) {
+    const { prompt } = await req.json();
+
+    const result = streamText({
+        model: safeModel,
+        prompt: prompt,
+    });
+
+    return result.toDataStreamResponse();
+}
+```
+
+#### Manual Sanitization Pipeline:
 ```typescript
 import { generateText } from 'ai';
 import { openai } from '@ai-sdk/openai';
@@ -517,7 +542,39 @@ test('pipeline prompt does not leak PII to third-party LLM', () => {
 
 ---
 
-### 10. Python, CrewAI & AutoGen Interop (Zero-Dependency HTTP Sidecar)
+### 11. Git Pre-Commit Leak Shield (Prevent Secret & PII Commits)
+
+Prevent developers and automated scripts from accidentally committing credentials, API keys, database URIs, or PII into git repositories with a single command:
+
+```bash
+# 1-Click install Zero-Trust pre-commit hook into .git/hooks/pre-commit:
+npx @privacyscrubber/sdk hook install
+# or using binary alias:
+npx ps-git-guard install
+
+# Standalone scan of staged changes anytime without committing:
+npx ps-git-guard
+# or:
+npx @privacyscrubber/sdk ps-git-guard
+
+# Remove hook when no longer needed:
+npx ps-git-guard uninstall
+```
+
+When installed, `git commit` automatically scans staged changes in <5ms. If secrets or PII are found, the commit is blocked with an actionable remediation banner:
+
+```text
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  🚨 [PrivacyScrubber Git Shield] UNMASKED SECRETS / PII INTERCEPTED!        ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Blocked commit: detected 2 sensitive token(s) in staged git diff.           ║
+║  Entity Types: AWS_KEY, OPENAI_KEY                                           ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+### 12. Python, CrewAI & AutoGen Interop (Zero-Dependency HTTP Sidecar)
 
 Running a Python agent fleet (CrewAI, LangGraph, AutoGen)? You can run `@privacyscrubber/sdk` as an air-gapped local sidecar daemon with sub-millisecond in-memory execution and zero cloud hops:
 
@@ -553,7 +610,7 @@ class PrivacyScrubberTool:
 
 ---
 
-### 11. Client-Side Website Form Interceptor (`@privacyscrubber/sdk/browser`)
+### 13. Client-Side Website Form Interceptor (`@privacyscrubber/sdk/browser`)
 
 Intercept customer support forms, loan applications, and lead generation inputs inside the browser DOM before network transmission. Dispatches safe surrogate tokens to public CRMs (Zendesk, HubSpot) or LLMs while isolating the encrypted `tokenMap` in your private database:
 
@@ -608,6 +665,12 @@ PrivacyScrubber works free out-of-the-box with standard developer limits:
 - **Free Tier ($0)**: Up to 15,000 characters per request for General profile; 5,000 characters free quota for specialized industry profiles. Built-in quota for local dev and CI testing without credit card or sign-up.
 - **Developer SDK License ($299/mo or $2,990/yr)**: Unlimited character throughput across all 30 specialized compliance profiles, unrestricted RAG & microservice batch pipelines, zero quota limits.
 
+### 7-Day Instant Evaluation Trial
+Evaluating in enterprise staging, ETL test environments, or PoC benchmarks? Activate an instant 7-day cryptographic Developer SDK evaluation trial:
+```bash
+npx @privacyscrubber/sdk trial
+```
+
 ### Activating Your Commercial License
 
 Set the environment variable or pass your key explicitly:

package/browser.js

@@ -149,8 +149,7 @@ export function buildAuditTelemetry(currentTokenMap = {}) {
     const ipHoldings = {
         standard: 'IETF draft-sibiryakov-ztds-protocol-00',
         standardUrl: 'https://datatracker.ietf.org/doc/draft-sibiryakov-ztds-protocol/',
-        patent: 'IL 331905 (Tracking: 94221)',
-        wipoDas: 'B17B',
+        patent: "U.S. & Int'l Patents Pending (Paris Convention Priority)",
         trademark: 'ZTDS™ Reg. #182655957 (ILPO Cl 9 & 42)'
     };
 

package/cli.js

@@ -23,13 +23,28 @@ const __dirname = path.dirname(__filename);
 
 const args = process.argv.slice(2);
 
+let sdkVersion = '2.3.7';
+try {
+  const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
+  sdkVersion = pkg.version || sdkVersion;
+} catch (_) {}
+
+// ── Git Guard Binary Alias Router ─────────────────────────────────
+const invokingScript = path.basename(process.argv[1] || '');
+const isGitGuardInvoked = invokingScript.includes('git-guard') || args.includes('git-guard') || args.includes('--git-guard');
+
+if (isGitGuardInvoked) {
+  if (args.includes('install') || args.includes('--install')) {
+    args.splice(0, args.length, 'hook', 'install');
+  } else if (args.includes('uninstall') || args.includes('--uninstall') || args.includes('remove')) {
+    args.splice(0, args.length, 'hook', 'uninstall');
+  } else if (!args.includes('scan-git-staged') && !args.includes('--scan-git-staged') && !args.includes('--help') && !args.includes('-h') && !args.includes('--version') && !args.includes('-v')) {
+    args.unshift('scan-git-staged');
+  }
+}
+
 if (args.includes('--version') || args.includes('-v')) {
-  let version = '2.2.5';
-  try {
-    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
-    version = pkg.version || version;
-  } catch (_) {}
-  console.log(`@privacyscrubber/sdk v${version}`);
+  console.log(`@privacyscrubber/sdk v${sdkVersion}`);
   process.exit(0);
 }
 
@@ -64,17 +79,23 @@ if (args.includes('mcp') || args.includes('--stdio-mcp') || args.includes('--mcp
     path.resolve(process.cwd(), 'mcp-server/index.js')
   ];
   const mcpServerPath = candidateMcpPaths.find(p => fs.existsSync(p));
+  const { spawn } = await import('node:child_process');
+  const forwardedArgs = args.filter(a => !['mcp', '--stdio-mcp', '--mcp'].includes(a));
+
   if (mcpServerPath) {
-    const { spawn } = await import('node:child_process');
-    const forwardedArgs = args.filter(a => !['mcp', '--stdio-mcp', '--mcp'].includes(a));
     const child = spawn(process.execPath, [mcpServerPath, ...forwardedArgs], {
       stdio: 'inherit'
     });
     child.on('exit', code => process.exit(code || 0));
     await new Promise(() => {});
   } else {
-    console.error('[PrivacyScrubber CLI Error] MCP Server runtime not found in local workspace.');
-    process.exit(1);
+    // Transparently forward to official @privacyscrubber/mcp-server package via npx
+    const child = spawn('npx', ['-y', '@privacyscrubber/mcp-server', ...forwardedArgs], {
+      stdio: 'inherit',
+      shell: process.platform === 'win32'
+    });
+    child.on('exit', code => process.exit(code || 0));
+    await new Promise(() => {});
   }
 }
 
@@ -131,7 +152,7 @@ if (args.includes('sidecar') || args.includes('--sidecar') || args.includes('ser
         engine: 'ZTDS',
         tier: lic.valid ? (lic.tier || 'SDK') : 'Community (Free Tier)',
         licensed: !!lic.valid,
-        version: '2.2.6',
+        version: sdkVersion,
         networkEgress: '0 bytes (100% in-memory RAM)',
         uptimeSec: Math.floor(process.uptime()),
         memoryMb: (process.memoryUsage().heapUsed / (1024 * 1024)).toFixed(2)
@@ -208,6 +229,19 @@ if (args.includes('sidecar') || args.includes('--sidecar') || args.includes('ser
           res.writeHead(404, { 'Content-Type': 'application/json' });
           res.end(JSON.stringify({ error: 'Endpoint Not Found. Supported: /v1/scrub, /v1/unscrub, /v1/health, /v1/metrics' }));
         } catch (err) {
+          if (err && err.name === 'PrivacyScrubberLicenseError') {
+            res.writeHead(402, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+              error: 'QUOTA_EXCEEDED',
+              message: err.message,
+              tier: err.tier || 'FREE',
+              limit: err.limit,
+              currentLength: err.currentLength,
+              profile: err.profile,
+              upgradeUrl: err.upgradeUrl || 'https://privacyscrubber.com/pricing?tier=sdk&src=sidecar_quota_limit'
+            }));
+            return;
+          }
           res.writeHead(400, { 'Content-Type': 'application/json' });
           res.end(JSON.stringify({ error: 'Invalid JSON payload or processing error', message: err.message }));
         }
@@ -288,6 +322,143 @@ ${res.scrubbedText.split('\n').map(l => `║  ${l.slice(0, 62).padEnd(64)}║`).
   process.exit(0);
 }
 
+// ── Trial Command: Instant 7-Day B2B Evaluation Trial ──────
+if (args.includes('trial') || args.includes('--trial')) {
+  console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  PrivacyScrubber Developer SDK — 7-Day B2B Evaluation Pilot                  ║
+║  Standard: Zero-Trust Data Sanitization (ZTDS)                               ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Evaluate high-throughput in-memory PII & secrets interception               ║
+║  across your backend microservices, CI/CD, and RAG pipelines.                ║
+║                                                                              ║
+║  1. Direct Instant Trial Activation:                                         ║
+║     https://privacyscrubber.com/pricing?tier=sdk&trial=true&src=sdk_cli_trial
+║                                                                              ║
+║  2. Set Environment Variable:                                                ║
+║     export PRIVACYSCRUBBER_KEY="PS-PILOT-XXXX-YYYY"                          ║
+║                                                                              ║
+║  3. Verify Activation:                                                       ║
+║     npx @privacyscrubber/sdk --verify-ci                                     ║
+║                                                                              ║
+║  Enterprise & Procurement Invoicing Contact:                                 ║
+║  enterprise@privacyscrubber.com                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+`);
+  process.exit(0);
+}
+
+// ── Git Pre-Commit Hook Management & Scan ─────────────────────────
+if (args.includes('hook') || args.includes('--hook')) {
+  const hookIdx = args.indexOf('hook') !== -1 ? args.indexOf('hook') : args.indexOf('--hook');
+  const hookSub = args[hookIdx + 1] || 'install';
+
+  if (hookSub === 'install') {
+    const gitDir = path.resolve(process.cwd(), '.git');
+    if (!fs.existsSync(gitDir)) {
+      console.error('[PrivacyScrubber Hook Error] Not a git repository (missing .git directory in current workspace).');
+      process.exit(1);
+    }
+    const hooksDir = path.join(gitDir, 'hooks');
+    if (!fs.existsSync(hooksDir)) fs.mkdirSync(hooksDir, { recursive: true });
+    const preCommitPath = path.join(hooksDir, 'pre-commit');
+
+    const hookScript = `#!/bin/sh
+# PrivacyScrubber Git Pre-Commit Leak Shield (ZTDS)
+# Blocks accidental commit of secrets, credentials, API keys and PII.
+if command -v npx >/dev/null 2>&1; then
+  npx @privacyscrubber/sdk scan-git-staged
+  EXIT_CODE=$?
+  if [ $EXIT_CODE -ne 0 ]; then
+    echo ""
+    echo "[PrivacyScrubber] Commit rejected. Fix secrets or bypass with: git commit --no-verify"
+    exit $EXIT_CODE
+  fi
+fi
+`;
+    if (fs.existsSync(preCommitPath)) {
+      const current = fs.readFileSync(preCommitPath, 'utf8');
+      if (current.includes('@privacyscrubber/sdk scan-git-staged')) {
+        console.log('[PrivacyScrubber Hook] Pre-commit hook is already installed in .git/hooks/pre-commit.');
+        process.exit(0);
+      }
+      fs.appendFileSync(preCommitPath, `\n${hookScript}\n`, 'utf8');
+    } else {
+      fs.writeFileSync(preCommitPath, hookScript, { encoding: 'utf8', mode: 0o755 });
+    }
+    try { fs.chmodSync(preCommitPath, 0o755); } catch (_) {}
+    console.log('[PrivacyScrubber Hook] Successfully installed Zero-Trust pre-commit hook in .git/hooks/pre-commit.');
+    console.log('[PrivacyScrubber Hook] Staged changes will now be audited for unmasked secrets before commit.');
+    process.exit(0);
+  }
+
+  if (hookSub === 'uninstall' || hookSub === 'remove') {
+    const preCommitPath = path.resolve(process.cwd(), '.git/hooks/pre-commit');
+    if (fs.existsSync(preCommitPath)) {
+      let content = fs.readFileSync(preCommitPath, 'utf8');
+      if (content.includes('@privacyscrubber/sdk scan-git-staged')) {
+        content = content.replace(/# PrivacyScrubber Git Pre-Commit Leak Shield[\s\S]*?fi\n?/g, '');
+        if (content.trim()) {
+          fs.writeFileSync(preCommitPath, content, 'utf8');
+        } else {
+          fs.unlinkSync(preCommitPath);
+        }
+        console.log('[PrivacyScrubber Hook] Pre-commit hook removed successfully.');
+        process.exit(0);
+      }
+    }
+    console.log('[PrivacyScrubber Hook] Pre-commit hook was not found in active repository.');
+    process.exit(0);
+  }
+}
+
+if (args.includes('scan-git-staged') || args.includes('--scan-git-staged')) {
+  try {
+    const { execSync } = require('child_process');
+    const diff = execSync('git diff --cached', { encoding: 'utf8', maxBuffer: 20 * 1024 * 1024 });
+    if (!diff || !diff.trim()) {
+      process.exit(0);
+    }
+
+    const addedLines = diff
+      .split('\n')
+      .filter(line => line.startsWith('+') && !line.startsWith('+++'))
+      .map(line => line.slice(1))
+      .join('\n');
+
+    if (!addedLines.trim()) {
+      process.exit(0);
+    }
+
+    const res = sanitize(addedLines, { profile: 'Dev', detectSecrets: true });
+    const maskedCount = Object.keys(res.tokenMap || {}).length;
+
+    if (maskedCount > 0) {
+      const entityTypes = Object.keys(res.telemetry?.entities || {}).join(', ');
+      console.error(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  🚨 [PrivacyScrubber Git Shield] UNMASKED SECRETS / PII INTERCEPTED!        ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Blocked commit: detected ${maskedCount} sensitive token(s) in staged git diff.            ║
+║  Entity Types: ${entityTypes.padEnd(58)} ║
+║                                                                              ║
+║  Remediation:                                                                ║
+║  1. Mask or revoke secrets before committing.                                ║
+║  2. To bypass in an emergency: git commit --no-verify                        ║
+║  3. Deploy automated in-memory masking across your CI/CD pipelines:          ║
+║     https://privacyscrubber.com/pricing?tier=sdk&src=git_precommit_shield   ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+`);
+      process.exit(1);
+    } else {
+      console.log('✅ [PrivacyScrubber Git Shield] Staged diff verified clean (0 secrets detected).');
+      process.exit(0);
+    }
+  } catch (err) {
+    process.exit(0);
+  }
+}
+
 if (args.includes('--help') || args.includes('-h') || (args.length === 0 && process.stdin.isTTY)) {
   console.log(`@privacyscrubber/sdk — Zero-Trust Data Sanitization & CI Security Verification
 
@@ -304,6 +475,9 @@ Commands:
   demo                 Run live in-memory benchmark (<0.1ms latency check)
   sidecar, serve       Run zero-dependency local HTTP/Unix daemon (<1ms in-memory)
   mcp, --stdio-mcp     Launch standard Model Context Protocol (MCP) server over stdio
+  hook install         Install pre-commit Git leak shield to block secret/PII commits
+  hook uninstall       Remove pre-commit Git leak shield
+  trial                Instant 7-day B2B evaluation trial activation instructions
 
 Options:
   --verify-ci          Generate CI/CD PR verification stamp (audit receipt)
@@ -324,6 +498,8 @@ Examples:
   cat build.log | npx @privacyscrubber/sdk --verify-ci
   npx @privacyscrubber/sdk memo > CISO_APPROVAL_MEMO.md
   npx @privacyscrubber/sdk demo
+  npx @privacyscrubber/sdk hook install
+  npx @privacyscrubber/sdk trial
   npx @privacyscrubber/sdk "Contact Alice at alice@acme.com" --profile dev
   echo "Hello [NAME_1]" | npx @privacyscrubber/sdk --restore --token-map '{"[NAME_1]":"Alice"}'
   cat stream.txt | npx @privacyscrubber/sdk --restore --stream --token-map tokens.json