specprotocol 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# SpecProtocol
+
+A **Minecraft bot framework** built from scratch in TypeScript — a Mineflayer alternative with full protocol support for **Java Edition 1.21.4** (Protocol 769).
+
+```bash
+npm install specprotocol
+```
+
+## ✨ Features
+
+- 🔌 **From-scratch protocol** — No dependency on `node-minecraft-protocol`
+- 🔐 **Auth support** — Offline (cracked) & Microsoft (Device Code Flow)
+- 🗜️ **Compression & Encryption** — Zlib + AES/CFB8 fully implemented
+- 🌍 **World management** — Chunk sections, block access by coordinates
+- 👾 **Entity tracking** — Spawn, remove, find nearest, spatial queries
+- 🧩 **Plugin system** — Built-in chat & combat + custom plugin API
+- 📦 **TypeScript-first** — Full type safety with typed events
+
+## 🚀 Quick Start
+
+```typescript
+import { createBot } from 'specprotocol';
+
+const bot = await createBot({
+  host: 'localhost',
+  port: 25565,
+  username: 'MyBot',
+  auth: 'offline', // or 'microsoft'
+});
+
+bot.on('spawn', () => {
+  console.log(`Spawned at ${bot.position}`);
+  bot.chat('Hello from SpecProtocol! 🤖');
+});
+
+bot.on('chat', (message) => {
+  console.log(`Chat: ${message}`);
+});
+
+bot.on('health', (health, food) => {
+  console.log(`Health: ${health}/20 | Food: ${food}/20`);
+});
+```
+
+## 📖 API
+
+### `createBot(options)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `host` | `string` | required | Server hostname |
+| `port` | `number` | `25565` | Server port |
+| `username` | `string` | required | Bot username |
+| `auth` | `'offline' \| 'microsoft'` | `'offline'` | Authentication mode |
+| `viewDistance` | `number` | `10` | Requested view distance |
+| `logLevel` | `LogLevel` | `INFO` | Logging verbosity |
+| `plugins` | `Plugin[]` | `[]` | Custom plugins to load |
+
+### Bot Events
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `spawn` | — | Bot spawned in world |
+| `chat` | `(message, isOverlay)` | Chat message received |
+| `health` | `(health, food, saturation)` | Health updated |
+| `death` | — | Bot died |
+| `position` | `(Vec3)` | Position updated by server |
+| `kicked` | `(reason)` | Kicked from server |
+| `entitySpawn` | `(Entity)` | Entity spawned nearby |
+| `entityRemove` | `(entityId)` | Entity removed |
+| `blockUpdate` | `(x, y, z, stateId)` | Block changed |
+| `error` | `(Error)` | Connection error |
+| `end` | — | Disconnected |
+
+### Bot Methods
+
+```typescript
+bot.chat('Hello!')                     // Send chat message
+bot.attack(entity)                     // Attack an entity
+bot.setPosition(x, y, z)             // Move to position
+bot.lookAt(new Vec3(x, y, z))        // Look at coordinates
+bot.dig(x, y, z)                     // Break a block
+bot.setHeldItem(slot)                // Select hotbar slot (0-8)
+bot.disconnect()                      // Disconnect from server
+```
+
+## 🧩 Custom Plugins
+
+```typescript
+import { createBot, type Plugin, type BotAPI } from 'specprotocol';
+
+class MyPlugin implements Plugin {
+  name = 'my-plugin';
+
+  initialize(bot: BotAPI): void {
+    bot.on('spawn', () => {
+      console.log('Bot spawned!');
+    });
+  }
+
+  destroy(): void {
+    // Cleanup
+  }
+}
+
+const bot = await createBot({
+  host: 'localhost',
+  username: 'Bot',
+  plugins: [new MyPlugin()],
+});
+```
+
+## 🛠️ Low-Level Access
+
+```typescript
+import { Connection, BufferReader, BufferWriter, PROTOCOL_VERSION } from 'specprotocol';
+
+// Direct packet access
+bot.on('rawPacket', (packet) => {
+  console.log(`Packet 0x${packet.id.toString(16)}: ${packet.data.length} bytes`);
+});
+
+// Send raw packets
+const writer = new BufferWriter();
+writer.writeVarInt(42);
+writer.writeString('hello');
+bot.sendPacket(0x06, writer.toBuffer());
+```
+
+## 📂 Architecture
+
+```
+specprotocol/
+├── src/
+│   ├── index.ts           # Public API exports
+│   ├── bot.ts             # Main Bot orchestrator
+│   ├── types.ts           # Shared types (BotAPI)
+│   ├── auth/
+│   │   ├── offline.ts     # Offline auth & UUID generation
+│   │   └── microsoft.ts   # Microsoft OAuth (Device Code Flow)
+│   ├── protocol/
+│   │   ├── types.ts       # VarInt, VarLong, BufferReader/Writer
+│   │   ├── packet.ts      # Packet framing, splitting, registry
+│   │   ├── connection.ts  # TCP connection manager
+│   │   ├── compression.ts # Zlib compression
+│   │   ├── encryption.ts  # AES/CFB8 encryption
+│   │   └── states/
+│   │       ├── handshake.ts
+│   │       ├── login.ts
+│   │       └── play.ts
+│   ├── entity/
+│   │   └── entity.ts      # Entity, PlayerEntity, EntityManager
+│   ├── world/
+│   │   ├── block.ts       # ChunkSection, ChunkColumn
+│   │   └── world.ts       # World manager
+│   ├── plugins/
+│   │   ├── plugin-manager.ts
+│   │   └── built-in/
+│   │       ├── chat.ts
+│   │       └── combat.ts
+│   └── utils/
+│       ├── vec3.ts        # 3D vector class
+│       ├── logger.ts      # Leveled logger
+│       └── events.ts      # Typed event emitter
+```
+
+## ⚙️ Requirements
+
+- **Node.js** ≥ 18
+- **Minecraft Java Edition** 1.21.4 (Protocol 769)
+
+## 📄 License
+
+MIT

package/bin/specprotocol.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+/**
+ * SpecProtocol CLI — Start a bot directly from the terminal.
+ * 
+ * After `npm install specprotocol`, just run:
+ *   specprotocol
+ * 
+ * Or with arguments:
+ *   specprotocol --host localhost --port 25565 --username MyBot
+ */
+
+const { createBot } = require('../dist/index.js');
+const readline = require('readline');
+
+const args = process.argv.slice(2);
+
+function getArg(name) {
+    const idx = args.indexOf(`--${name}`);
+    if (idx !== -1 && args[idx + 1]) return args[idx + 1];
+    return null;
+}
+
+function ask(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+
+async function main() {
+    console.log('');
+    console.log('  ╔═══════════════════════════════════╗');
+    console.log('  ║       🎮 SpecProtocol v1.0        ║');
+    console.log('  ║   Minecraft Bot Framework (1.21.4) ║');
+    console.log('  ╚═══════════════════════════════════╝');
+    console.log('');
+
+    // Get config from args or ask interactively
+    const host = getArg('host') || await ask('  Sunucu adresi (localhost): ') || 'localhost';
+    const port = parseInt(getArg('port') || await ask('  Port (25565): ') || '25565');
+    const username = getArg('username') || await ask('  Bot adı (SpecBot): ') || 'SpecBot';
+    const auth = getArg('auth') || 'offline';
+
+    console.log('');
+    console.log(`  → ${host}:${port} adresine "${username}" olarak bağlanılıyor...`);
+    console.log('');
+
+    try {
+        const bot = await createBot({
+            host,
+            port,
+            username,
+            auth,
+        });
+
+        bot.on('spawn', () => {
+            console.log(`  ✅ Dünyada doğuldu! Pozisyon: ${bot.position}`);
+            console.log('');
+            console.log('  Komutlar:');
+            console.log('    say <mesaj>   — Chat mesajı gönder');
+            console.log('    pos           — Pozisyonu göster');
+            console.log('    health        — Sağlık bilgisi');
+            console.log('    quit          — Çıkış');
+            console.log('');
+            startRepl(bot);
+        });
+
+        bot.on('chat', (message, isOverlay) => {
+            if (!isOverlay) {
+                console.log(`  💬 ${message}`);
+            }
+        });
+
+        bot.on('health', (health, food) => {
+            if (health <= 0) console.log('  💀 Bot öldü!');
+        });
+
+        bot.on('kicked', (reason) => {
+            console.log(`  🚫 Sunucudan atıldı: ${reason}`);
+            process.exit(1);
+        });
+
+        bot.on('error', (err) => {
+            console.error(`  ❌ Hata: ${err.message}`);
+        });
+
+        bot.on('end', () => {
+            console.log('  🔌 Bağlantı kesildi');
+            process.exit(0);
+        });
+
+    } catch (err) {
+        console.error(`  ❌ Bağlantı kurulamadı: ${err.message}`);
+        process.exit(1);
+    }
+}
+
+function startRepl(bot) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: '  > ',
+    });
+
+    rl.prompt();
+
+    rl.on('line', (line) => {
+        const input = line.trim();
+
+        if (input.startsWith('say ')) {
+            bot.chat(input.substring(4));
+        } else if (input === 'pos') {
+            console.log(`  📍 ${bot.position}`);
+        } else if (input === 'health') {
+            console.log(`  ❤️ Can: ${bot.health}/20 | 🍖 Açlık: ${bot.food}/20`);
+        } else if (input === 'quit' || input === 'exit') {
+            bot.disconnect();
+            process.exit(0);
+        } else if (input) {
+            console.log('  Bilinmeyen komut. Komutlar: say, pos, health, quit');
+        }
+
+        rl.prompt();
+    });
+
+    rl.on('close', () => {
+        bot.disconnect();
+        process.exit(0);
+    });
+}
+
+main();

package/dist/auth/microsoft.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Microsoft Authentication for Minecraft Java Edition.
+ *
+ * Auth chain: Microsoft OAuth2 → Xbox Live → XSTS → Minecraft Services
+ *
+ * This implements the Device Code Flow (user opens a browser to authenticate).
+ */
+export interface MicrosoftAuthResult {
+    accessToken: string;
+    username: string;
+    uuid: string;
+}
+/**
+ * Authenticate using Microsoft Device Code Flow.
+ * Returns a callback with the device code info, and a promise that resolves to the auth result.
+ */
+export declare function authenticateMicrosoft(onDeviceCode: (userCode: string, verificationUri: string) => void): Promise<MicrosoftAuthResult>;
+/**
+ * Join a server (session server authentication).
+ * Called after encrypting the shared secret, before sending Encryption Response.
+ */
+export declare function joinServer(accessToken: string, selectedProfile: string, serverHash: string): Promise<void>;
+//# sourceMappingURL=microsoft.d.ts.map

package/dist/auth/microsoft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft.d.ts","sourceRoot":"","sources":["../../src/auth/microsoft.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB;AAwCD;;;GAGG;AACH,wBAAsB,qBAAqB,CACvC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,IAAI,GAClE,OAAO,CAAC,mBAAmB,CAAC,CA0B9B;AA6HD;;;GAGG;AACH,wBAAsB,UAAU,CAC5B,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/auth/microsoft.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Microsoft Authentication for Minecraft Java Edition.
+ *
+ * Auth chain: Microsoft OAuth2 → Xbox Live → XSTS → Minecraft Services
+ *
+ * This implements the Device Code Flow (user opens a browser to authenticate).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authenticateMicrosoft = authenticateMicrosoft;
+exports.joinServer = joinServer;
+// Microsoft Azure App Client ID for Minecraft
+const CLIENT_ID = '00000000402b5328';
+const AUTHORITY = 'https://login.live.com';
+/**
+ * Authenticate using Microsoft Device Code Flow.
+ * Returns a callback with the device code info, and a promise that resolves to the auth result.
+ */
+async function authenticateMicrosoft(onDeviceCode) {
+    // Step 1: Get Device Code
+    const deviceCode = await requestDeviceCode();
+    onDeviceCode(deviceCode.user_code, deviceCode.verification_uri);
+    // Step 2: Poll for Microsoft Token
+    const msToken = await pollForToken(deviceCode);
+    // Step 3: Xbox Live Auth
+    const xboxToken = await authenticateXboxLive(msToken.access_token);
+    // Step 4: XSTS Token
+    const xstsToken = await authenticateXSTS(xboxToken.Token);
+    // Step 5: Minecraft Auth
+    const uhs = xstsToken.DisplayClaims.xui[0].uhs;
+    const mcAuth = await authenticateMinecraft(uhs, xstsToken.Token);
+    // Step 6: Get Minecraft Profile
+    const profile = await getMinecraftProfile(mcAuth.access_token);
+    return {
+        accessToken: mcAuth.access_token,
+        username: profile.name,
+        uuid: formatUUID(profile.id),
+    };
+}
+async function requestDeviceCode() {
+    const response = await fetch(`${AUTHORITY}/oauth20_connect.srf`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: new URLSearchParams({
+            client_id: CLIENT_ID,
+            scope: 'XboxLive.signin offline_access',
+            response_type: 'device_code',
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`Device code request failed: ${response.status}`);
+    return response.json();
+}
+async function pollForToken(deviceCode) {
+    const intervalMs = (deviceCode.interval || 5) * 1000;
+    const expiresAt = Date.now() + deviceCode.expires_in * 1000;
+    while (Date.now() < expiresAt) {
+        await sleep(intervalMs);
+        const response = await fetch(`${AUTHORITY}/oauth20_token.srf`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams({
+                client_id: CLIENT_ID,
+                grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+                device_code: deviceCode.device_code,
+            }),
+        });
+        const data = await response.json();
+        if (data.error === 'authorization_pending') {
+            continue;
+        }
+        if (data.error) {
+            throw new Error(`Token polling error: ${data.error} — ${data.error_description}`);
+        }
+        return data;
+    }
+    throw new Error('Device code expired');
+}
+async function authenticateXboxLive(msAccessToken) {
+    const response = await fetch('https://user.auth.xboxlive.com/user/authenticate', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        },
+        body: JSON.stringify({
+            Properties: {
+                AuthMethod: 'RPS',
+                SiteName: 'user.auth.xboxlive.com',
+                RpsTicket: `d=${msAccessToken}`,
+            },
+            RelyingParty: 'http://auth.xboxlive.com',
+            TokenType: 'JWT',
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`Xbox Live auth failed: ${response.status}`);
+    return response.json();
+}
+async function authenticateXSTS(xboxToken) {
+    const response = await fetch('https://xsts.auth.xboxlive.com/xsts/authorize', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        },
+        body: JSON.stringify({
+            Properties: {
+                SandboxId: 'RETAIL',
+                UserTokens: [xboxToken],
+            },
+            RelyingParty: 'rp://api.minecraftservices.com/',
+            TokenType: 'JWT',
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`XSTS auth failed: ${response.status}`);
+    return response.json();
+}
+async function authenticateMinecraft(uhs, xstsToken) {
+    const response = await fetch('https://api.minecraftservices.com/authentication/login_with_xbox', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            identityToken: `XBL3.0 x=${uhs};${xstsToken}`,
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`Minecraft auth failed: ${response.status}`);
+    return response.json();
+}
+async function getMinecraftProfile(accessToken) {
+    const response = await fetch('https://api.minecraftservices.com/minecraft/profile', {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+        },
+    });
+    if (!response.ok)
+        throw new Error(`Failed to get Minecraft profile: ${response.status}`);
+    return response.json();
+}
+function formatUUID(hex) {
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Join a server (session server authentication).
+ * Called after encrypting the shared secret, before sending Encryption Response.
+ */
+async function joinServer(accessToken, selectedProfile, serverHash) {
+    const response = await fetch('https://sessionserver.mojang.com/session/minecraft/join', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            accessToken,
+            selectedProfile: selectedProfile.replace(/-/g, ''),
+            serverId: serverHash,
+        }),
+    });
+    if (response.status !== 204 && !response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Failed to join server session: ${response.status} — ${errorText}`);
+    }
+}
+//# sourceMappingURL=microsoft.js.map

package/dist/auth/microsoft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft.js","sourceRoot":"","sources":["../../src/auth/microsoft.ts"],"names":[],"mappings":"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"}

package/dist/auth/offline.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Offline Authentication — for cracked/offline mode servers.
+ *
+ * In offline mode, no external auth is needed.
+ * The client just provides a username and generates an offline UUID.
+ */
+export interface OfflineProfile {
+    username: string;
+    uuid: string;
+}
+/**
+ * Generate an offline UUID from a username.
+ * Minecraft uses "OfflinePlayer:<username>" hashed with MD5, then sets version/variant bits.
+ */
+export declare function offlineUUID(username: string): string;
+/**
+ * Create an offline profile from a username.
+ */
+export declare function createOfflineProfile(username: string): OfflineProfile;
+//# sourceMappingURL=offline.d.ts.map

package/dist/auth/offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/auth/offline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAKrE"}

package/dist/auth/offline.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Offline Authentication — for cracked/offline mode servers.
+ *
+ * In offline mode, no external auth is needed.
+ * The client just provides a username and generates an offline UUID.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.offlineUUID = offlineUUID;
+exports.createOfflineProfile = createOfflineProfile;
+const crypto = __importStar(require("crypto"));
+/**
+ * Generate an offline UUID from a username.
+ * Minecraft uses "OfflinePlayer:<username>" hashed with MD5, then sets version/variant bits.
+ */
+function offlineUUID(username) {
+    const md5 = crypto.createHash('md5').update(`OfflinePlayer:${username}`).digest();
+    // Set version to 3 (name-based MD5)
+    md5[6] = (md5[6] & 0x0F) | 0x30;
+    // Set variant to IETF
+    md5[8] = (md5[8] & 0x3F) | 0x80;
+    const hex = md5.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/**
+ * Create an offline profile from a username.
+ */
+function createOfflineProfile(username) {
+    return {
+        username,
+        uuid: offlineUUID(username),
+    };
+}
+//# sourceMappingURL=offline.js.map

package/dist/auth/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","sourceRoot":"","sources":["../../src/auth/offline.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaH,kCAUC;AAKD,oDAKC;AA/BD,+CAAiC;AAOjC;;;GAGG;AACH,SAAgB,WAAW,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAElF,oCAAoC;IACpC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACjC,sBAAsB;IACtB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEjC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/G,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,QAAgB;IACjD,OAAO;QACH,QAAQ;QACR,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC;KAC9B,CAAC;AACN,CAAC"}