dtunnel-sdk 1.1.4 → 1.2.0

package/README.md

@@ -10,7 +10,7 @@ npm install dtunnel-sdk
 
 ## Inicializar projeto pronto
 
-Crie um projeto novo com template e `build:webview` ja configurado:
+Crie um projeto novo com template e `build:android` ja configurado:
 
 ```bash
 npx dtunnel-sdk init
@@ -30,49 +30,55 @@ Tambem funciona com `npm exec`:
 npm exec dtunnel-sdk init meu-app --template react-typescript
 ```
 
-## Uso rapido
+## Uso rapido
 
 ```ts
 import DTunnelSDK from 'dtunnel-sdk';
 
-const sdk = new DTunnelSDK({
-  strict: false,
-  autoRegisterNativeEvents: true,
-});
+const sdk = new DTunnelSDK({
+  strict: false,
+  autoRegisterNativeEvents: true,
+});
 
 sdk.on('vpnState', (event) => {
   console.log('VPN:', event.payload);
-});
-```
-
-## Simulador rapido (sem Android)
-
-```ts
-import DTunnelSDK from 'dtunnel-sdk';
-import { installDTunnelSDKSimulator } from 'dtunnel-sdk/simulator';
-
-const simulator = installDTunnelSDKSimulator();
-const sdk = new DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
-
-simulator.emit('vpnState', 'CONNECTED');
-```
-
-Browser puro (sem bundler):
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.simulator.js"></script>
-```
-
-Nota:
-- No WebView real, o simulador nao instala por padrao se detectar bridge nativa.
+});
+```
+
+## Simulador rapido (sem Android)
+
+```ts
+import DTunnelSDK from 'dtunnel-sdk';
+import { installDTunnelSDKSimulator } from 'dtunnel-sdk/simulator';
 
-CDN:
+const simulator = installDTunnelSDKSimulator();
+const sdk = new DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
+
+sdk.on('vpnState', (event) => {
+  console.log('VPN:', event.payload);
+});
+simulator.emit('vpnState', 'CONNECTED');
+```
+
+Browser puro (sem bundler):
 
 ```html
 <script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.simulator.js"></script>
+<script>
+  const sdk = new window.DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
+  const simulator = window.DTunnelSDKSimulator.installDTunnelSDKSimulator();
+
+  sdk.on('vpnState', (event) => {
+    console.log('VPN:', event.payload);
+  });
+  simulator.emit('vpnState', 'CONNECTED');
+</script>
 ```
 
+Nota:
+- No WebView real, o simulador nao instala por padrao se detectar bridge nativa.
+
 ## Documentacao completa
 
 Toda a documentacao foi movida para `docs/`:
@@ -87,14 +93,14 @@ Toda a documentacao foi movida para `docs/`:
 
 Use apenas `init` para gerar projeto pronto:
 
-```bash
-npx dtunnel-sdk init meu-app --template react-typescript
-cd meu-app
-npm run build:webview
-```
-
-O resultado final para o WebView sempre sera:
-- `webview/index.html`
+```bash
+npx dtunnel-sdk init meu-app --template react-typescript
+cd meu-app
+npm run build:android
+```
+
+O resultado final para Android e um arquivo unico:
+- `dist/build.html`
 
 ## Demos prontas
 
@@ -116,6 +122,6 @@ npm run test:typecheck
 ## Release e publicacao
 
 ```bash
-npm run release:sdk -- --version X.Y.Z
-npm run publish:npm
-```
+npm run release:sdk -- --version X.Y.Z
+npm run release:npm
+```

package/bin/dtunnel-sdk.mjs

@@ -11,6 +11,7 @@ const __dirname = path.dirname(__filename);
 const ROOT_DIR = path.resolve(__dirname, '..');
 const TEMPLATES_DIR = path.join(ROOT_DIR, 'templates');
 const PKG_JSON_PATH = path.join(ROOT_DIR, 'package.json');
+const REQUIRED_GITIGNORE_ENTRIES = ['node_modules', 'dist'];
 
 const TEMPLATE_CHOICES = [
   { id: 'react-typescript', label: 'React + TypeScript (Vite)' },
@@ -258,6 +259,67 @@ async function copyDirRecursive(sourceDir, targetDir) {
   }
 }
 
+async function normalizeIgnoreFiles(targetDir) {
+  const entries = await fs.readdir(targetDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    await normalizeIgnoreFiles(path.join(targetDir, entry.name));
+  }
+
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  const npmignorePath = path.join(targetDir, '.npmignore');
+  const plainIgnorePath = path.join(targetDir, 'gitignore');
+  const hasGitignore = await pathExists(gitignorePath);
+
+  if (!hasGitignore && (await pathExists(npmignorePath))) {
+    await fs.rename(npmignorePath, gitignorePath);
+  } else if (!hasGitignore && (await pathExists(plainIgnorePath))) {
+    await fs.rename(plainIgnorePath, gitignorePath);
+  }
+
+  if ((await pathExists(gitignorePath)) && (await pathExists(npmignorePath))) {
+    await fs.rm(npmignorePath, { force: true });
+  }
+
+  if ((await pathExists(gitignorePath)) && (await pathExists(plainIgnorePath))) {
+    await fs.rm(plainIgnorePath, { force: true });
+  }
+}
+
+async function ensureRootGitignoreDefaults(targetDir) {
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  const hasGitignore = await pathExists(gitignorePath);
+
+  if (!hasGitignore) {
+    await fs.writeFile(
+      gitignorePath,
+      `${REQUIRED_GITIGNORE_ENTRIES.join('\n')}\n`,
+      'utf8',
+    );
+    return;
+  }
+
+  const raw = await fs.readFile(gitignorePath, 'utf8');
+  const normalized = raw.replace(/\r\n/g, '\n');
+  const existing = new Set(
+    normalized
+      .split('\n')
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0),
+  );
+  const missing = REQUIRED_GITIGNORE_ENTRIES.filter((line) => !existing.has(line));
+
+  if (missing.length === 0) return;
+
+  let next = normalized;
+  if (next.length > 0 && !next.endsWith('\n')) {
+    next += '\n';
+  }
+  next += `${missing.join('\n')}\n`;
+  await fs.writeFile(gitignorePath, next, 'utf8');
+}
+
 function isTextLikeFile(fileName) {
   if (fileName === '.gitignore') return true;
   const ext = path.extname(fileName);
@@ -338,16 +400,16 @@ function printNextSteps({
   }
 
   if (template === 'cdn') {
-    console.log(`  ${runScriptCommand(packageManager, 'build:webview')}`);
-    console.log('\nArquivo final para WebView:');
-    console.log(`  ${path.join(projectName, 'webview', 'index.html')}`);
+    console.log(`  ${runScriptCommand(packageManager, 'build:android')}`);
+    console.log('\nArquivo final para Android (unico):');
+    console.log(`  ${path.join(projectName, 'dist', 'build.html')}`);
     return;
   }
 
   console.log(`  ${runScriptCommand(packageManager, 'dev')}`);
-  console.log(`  ${runScriptCommand(packageManager, 'build:webview')}`);
-  console.log('\nArquivo final para WebView:');
-  console.log(`  ${path.join(projectName, 'webview', 'index.html')}`);
+  console.log(`  ${runScriptCommand(packageManager, 'build:android')}`);
+  console.log('\nArquivo final para Android (unico):');
+  console.log(`  ${path.join(projectName, 'dist', 'build.html')}`);
 }
 
 async function runInit(parsed) {
@@ -402,6 +464,8 @@ async function runInit(parsed) {
     const targetDir = path.resolve(process.cwd(), projectName);
     await ensureTargetDirectory(targetDir, parsed.force);
     await copyDirRecursive(templateDir, targetDir);
+    await normalizeIgnoreFiles(targetDir);
+    await ensureRootGitignoreDefaults(targetDir);
 
     const sdkVersion = await readSdkVersion();
     await applyReplacements(targetDir, {

package/docs/getting-started.md

@@ -8,7 +8,7 @@ npm install dtunnel-sdk
 
 ## Bootstrap de projeto (CLI)
 
-Crie um projeto novo com template e script de WebView pronto:
+Crie um projeto novo com template e script de build para Android pronto:
 
 ```bash
 npx dtunnel-sdk init
@@ -82,21 +82,21 @@ export function App() {
 </script>
 ```
 
-## Regra de WebView: sempre um unico `index.html`
-
-Para publicar no WebView Android, entregue um arquivo unico com CSS/JS embutidos.
-
-- Todo projeto criado pelo CLI gera `webview/index.html`.
-
-Fluxo recomendado:
+## Build para Android em arquivo unico
+
+Para publicar no Android, o artefato final e um unico `dist/build.html`.
+
+- Todo projeto criado pelo CLI inclui `npm run build:android`.
+
+Fluxo recomendado:
 
 ```bash
 npx dtunnel-sdk init meu-app --template react-typescript
 cd meu-app
-npm run build:webview
-```
-
-## Comportamento de erro (`strict`)
+npm run build:android
+```
+
+## Comportamento de erro (`strict`)
 
 - `strict: false` (padrao recomendado para WebView): erros de bridge retornam `null` e disparam evento `error`.
 - `strict: true`: a chamada lanca `DTunnelBridgeError`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dtunnel-sdk",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "JavaScript/TypeScript SDK for the DTunnel Android WebView bridge.",
   "license": "MIT",
   "type": "commonjs",
@@ -10,13 +10,12 @@
   "bin": {
     "dtunnel-sdk": "bin/dtunnel-sdk.mjs"
   },
-  "scripts": {
-    "test": "node --import tsx --test ./tests/*.test.mts",
-    "test:typecheck": "tsc -p ./tests/tsconfig.json --noEmit",
-    "publish:npm": "node ./scripts/publish-npm.mjs",
-    "publish:npm:dry": "node ./scripts/publish-npm.mjs --dry-run --skip-auth",
-    "release:sdk": "node ./scripts/release-sdk.mjs"
-  },
+  "scripts": {
+    "test": "node --import tsx --test ./tests/*.test.mts",
+    "test:typecheck": "tsc -p ./tests/tsconfig.json --noEmit",
+    "release:npm": "node ./scripts/release-npm.mjs",
+    "release:sdk": "node ./scripts/release-sdk.mjs"
+  },
   "exports": {
     ".": {
       "types": "./sdk/dtunnel-sdk.d.ts",

package/sdk/README.md

@@ -1,60 +1,60 @@
 # DTunnel SDK (Runtime)
 
-Arquivos do runtime e tipagem:
-
-- `dtunnel-sdk.js`: build principal (script tag + CommonJS)
-- `dtunnel-sdk.mjs`: entrada ESM para bundlers
-- `dtunnel-sdk.d.ts`: tipagem TypeScript
-- `dtunnel-sdk.simulator.js`: simulador da bridge (`window.Dt...`)
-- `dtunnel-sdk.simulator.d.ts`: tipagem TypeScript do simulador
-- `dtunnel-sdk.simulator.mjs`: entrada ESM do simulador
+Arquivos do runtime e tipagem:
+
+- `dtunnel-sdk.js`: build principal (script tag + CommonJS)
+- `dtunnel-sdk.mjs`: entrada ESM para bundlers
+- `dtunnel-sdk.d.ts`: tipagem TypeScript
+- `dtunnel-sdk.simulator.js`: simulador da bridge (`window.Dt...`)
+- `dtunnel-sdk.simulator.d.ts`: tipagem TypeScript do simulador
+- `dtunnel-sdk.simulator.mjs`: entrada ESM do simulador
 
 ## Inicializacao
 
 ```ts
-import DTunnelSDK from 'dtunnel-sdk';
-
-const sdk = new DTunnelSDK({
-  strict: false,
-  autoRegisterNativeEvents: true,
-});
-```
-
-## Simulador da bridge no navegador
-
-### Uso
-
-```ts
-import DTunnelSDK from 'dtunnel-sdk';
-import { installDTunnelSDKSimulator } from 'dtunnel-sdk/simulator';
-
-const simulator = installDTunnelSDKSimulator();
-const sdk = new DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
-
-sdk.main.startVpn(); // usa simulador
-simulator.emit('vpnState', 'CONNECTED'); // dispara callback nativo
-```
-
-### Regra de WebView real
-
-Por padrao, `installDTunnelSDKSimulator()` nao instala se detectar bridge nativa no `window` (nao sobrescreve `window.Dt...` no app real).
-
-### Script tag (CDN/browser puro)
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.simulator.js"></script>
-```
-
-Depois disso:
-
-```html
-<script>
-  const sdk = new window.DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
-  const simulator = window.DTunnelSDKSimulator.installDTunnelSDKSimulator();
-  simulator.emit('vpnState', 'CONNECTED');
-</script>
-```
+import DTunnelSDK from 'dtunnel-sdk';
+
+const sdk = new DTunnelSDK({
+  strict: false,
+  autoRegisterNativeEvents: true,
+});
+```
+
+## Simulador da bridge no navegador
+
+### Uso
+
+```ts
+import DTunnelSDK from 'dtunnel-sdk';
+import { installDTunnelSDKSimulator } from 'dtunnel-sdk/simulator';
+
+const simulator = installDTunnelSDKSimulator();
+const sdk = new DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
+
+sdk.main.startVpn(); // usa simulador
+simulator.emit('vpnState', 'CONNECTED'); // dispara callback nativo
+```
+
+### Regra de WebView real
+
+Por padrao, `installDTunnelSDKSimulator()` nao instala se detectar bridge nativa no `window` (nao sobrescreve `window.Dt...` no app real).
+
+### Script tag (CDN/browser puro)
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/dtunnel-sdk@latest/sdk/dtunnel-sdk.simulator.js"></script>
+```
+
+Depois disso:
+
+```html
+<script>
+  const sdk = new window.DTunnelSDK({ strict: false, autoRegisterNativeEvents: true });
+  const simulator = window.DTunnelSDKSimulator.installDTunnelSDKSimulator();
+  simulator.emit('vpnState', 'CONNECTED');
+</script>
+```
 
 ## Modulos
 
@@ -93,12 +93,10 @@ Use `sdk.on('<evento>', handler)` com:
 - React + TypeScript: `examples/react-typescript`
 - Guia geral: `examples/README.md`
 
-Regra para WebView:
-- entregue sempre um unico `index.html` com CSS/JS embutido.
-- nos exemplos TypeScript/React, use `npm run build:webview` para gerar `webview/index.html`.
-- atalho na raiz: `npm run examples:webview`.
+Regra para WebView:
+- use `npm run build:android` para gerar `dist/build.html` (arquivo unico).
 
 Publicacao npm (raiz do repo):
-- scripts de publicacao/release sao cross-platform (Linux, macOS e Windows).
-- `npm login`
-- `npm run publish:npm`
+- scripts de publicacao/release sao cross-platform (Linux, macOS e Windows).
+- `npm login`
+- `npm run release:npm`

package/sdk/dtunnel-sdk.js

@@ -698,7 +698,7 @@
     }
   }
 
-  DTunnelSDK.VERSION = '1.1.4';
+  DTunnelSDK.VERSION = '1.2.0';
   DTunnelSDK.BRIDGE_OBJECTS = BRIDGE_OBJECTS;
   DTunnelSDK.EVENT_DEFINITIONS = EVENT_DEFINITIONS;
   DTunnelSDK.DTunnelBridgeError = DTunnelBridgeError;

package/templates/cdn/README.md

@@ -5,11 +5,11 @@ Projeto pronto para uso com CDN.
 ## Comandos
 
 ```bash
-npm run build:webview
+npm run build:android
 ```
 
 Saida:
-- `webview/index.html`
+- `dist/build.html`
 
 ## Uso
 

package/templates/cdn/package.json

@@ -5,6 +5,6 @@
   "type": "module",
   "scripts": {
     "dev": "node -e \"console.log('Abra index.html no navegador ou WebView.')\"",
-    "build:webview": "node ./scripts/copy-webview.mjs"
+    "build:android": "node ./scripts/build-android-html.mjs"
   }
-}
+}

package/templates/cdn/scripts/{copy-webview.mjs → build-android-html.mjs}

@@ -4,10 +4,10 @@ import path from 'node:path';
 
 const cwd = process.cwd();
 const inputPath = path.join(cwd, 'index.html');
-const outputPath = path.join(cwd, 'webview', 'index.html');
+const outputPath = path.join(cwd, 'dist', 'build.html');
 
 const html = await fs.readFile(inputPath, 'utf8');
 await fs.mkdir(path.dirname(outputPath), { recursive: true });
 await fs.writeFile(outputPath, html, 'utf8');
 
-console.log(`[build-webview] Gerado: ${outputPath}`);
+console.log(`[build-android] Gerado: ${outputPath}`);

package/templates/react-typescript/README.md

@@ -1,14 +1,14 @@
 # DTunnel SDK - Template React + TypeScript
 
-Projeto React + TypeScript (Vite) pronto com `build:webview`.
+Projeto React + TypeScript (Vite) pronto com `build:android`.
 
 ## Comandos
 
 ```bash
 npm install
 npm run dev
-npm run build:webview
+npm run build:android
 ```
 
-Saida:
-- `webview/index.html`
+Saida:
+- `dist/build.html` (arquivo unico)

package/templates/react-typescript/package.json

@@ -6,7 +6,7 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "build:webview": "npm run build && node ./scripts/build-webview-html.mjs --dist dist --out webview/index.html",
+    "build:android": "npm run build && node ./scripts/build-android-html.mjs --dist dist --out dist/build.html",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit"
   },

package/templates/react-typescript/scripts/{build-webview-html.mjs → build-android-html.mjs}

@@ -6,7 +6,7 @@ import process from 'node:process';
 function parseArgs(argv) {
   const options = {
     dist: 'dist',
-    out: 'webview/index.html',
+    out: 'dist/build.html',
   };
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -116,6 +116,23 @@ function removeLocalModulePreloads(html) {
   });
 }
 
+async function keepOnlyOutputFile(outputPath) {
+  const outputDir = path.dirname(outputPath);
+  const entries = await fs.readdir(outputDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const entryPath = path.join(outputDir, entry.name);
+    if (path.resolve(entryPath) === outputPath) continue;
+
+    if (entry.isDirectory()) {
+      await fs.rm(entryPath, { recursive: true, force: true });
+      continue;
+    }
+
+    await fs.rm(entryPath, { force: true });
+  }
+}
+
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   const cwd = process.cwd();
@@ -126,7 +143,7 @@ async function main() {
   const outputDir = path.dirname(outputPath);
 
   if (!(await fileExists(inputPath))) {
-    console.error(`[build-html] index nao encontrado: ${inputPath}`);
+    console.error(`[build-android] index nao encontrado: ${inputPath}`);
     process.exit(1);
   }
 
@@ -137,11 +154,12 @@ async function main() {
 
   await fs.mkdir(outputDir, { recursive: true });
   await fs.writeFile(outputPath, html, 'utf8');
+  await keepOnlyOutputFile(outputPath);
 
-  console.log(`[build-html] Gerado: ${outputPath}`);
+  console.log(`[build-android] Gerado: ${outputPath}`);
 }
 
 main().catch((error) => {
-  console.error('[build-html] Falha:', error);
+  console.error('[build-android] Falha:', error);
   process.exit(1);
 });

package/templates/typescript/README.md

@@ -1,14 +1,14 @@
 # DTunnel SDK - Template TypeScript
 
-Projeto TypeScript (Vite) pronto com `build:webview`.
+Projeto TypeScript (Vite) pronto com `build:android`.
 
 ## Comandos
 
 ```bash
 npm install
 npm run dev
-npm run build:webview
+npm run build:android
 ```
 
-Saida:
-- `webview/index.html`
+Saida:
+- `dist/build.html` (arquivo unico)

package/templates/typescript/package.json

@@ -6,7 +6,7 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "build:webview": "npm run build && node ./scripts/build-webview-html.mjs --dist dist --out webview/index.html",
+    "build:android": "npm run build && node ./scripts/build-android-html.mjs --dist dist --out dist/build.html",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit"
   },

package/templates/typescript/scripts/{build-webview-html.mjs → build-android-html.mjs}

@@ -6,7 +6,7 @@ import process from 'node:process';
 function parseArgs(argv) {
   const options = {
     dist: 'dist',
-    out: 'webview/index.html',
+    out: 'dist/build.html',
   };
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -116,6 +116,23 @@ function removeLocalModulePreloads(html) {
   });
 }
 
+async function keepOnlyOutputFile(outputPath) {
+  const outputDir = path.dirname(outputPath);
+  const entries = await fs.readdir(outputDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const entryPath = path.join(outputDir, entry.name);
+    if (path.resolve(entryPath) === outputPath) continue;
+
+    if (entry.isDirectory()) {
+      await fs.rm(entryPath, { recursive: true, force: true });
+      continue;
+    }
+
+    await fs.rm(entryPath, { force: true });
+  }
+}
+
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   const cwd = process.cwd();
@@ -126,7 +143,7 @@ async function main() {
   const outputDir = path.dirname(outputPath);
 
   if (!(await fileExists(inputPath))) {
-    console.error(`[build-html] index nao encontrado: ${inputPath}`);
+    console.error(`[build-android] index nao encontrado: ${inputPath}`);
     process.exit(1);
   }
 
@@ -137,11 +154,12 @@ async function main() {
 
   await fs.mkdir(outputDir, { recursive: true });
   await fs.writeFile(outputPath, html, 'utf8');
+  await keepOnlyOutputFile(outputPath);
 
-  console.log(`[build-html] Gerado: ${outputPath}`);
+  console.log(`[build-android] Gerado: ${outputPath}`);
 }
 
 main().catch((error) => {
-  console.error('[build-html] Falha:', error);
+  console.error('[build-android] Falha:', error);
   process.exit(1);
 });