@loom-framework/core 0.1.0-alpha.17 → 0.1.0-alpha.171

package/dist/capability-generator.js

@@ -1,288 +1,115 @@
 /**
  * Capability Generator
  *
- * Core innovation: One schema definition → MCP Server + CLI commands
+ * Core innovation: One schema definition → Skill + CLI data access
  *
  * From loom.config.ts model definitions, generates:
- * 1. MCP Server (.loom/mcp-server/) - structured data CRUD tools
- * 2. CLI data commands (cli/commands/data/) - dev/debug data access
- * 3. MCP config (.loom/mcp.json) - Claude Code MCP registration
+ * 1. SKILL.md — guided instructions for AI to write natural language (only on first run, never overwritten)
+ * 2. references/models.md — auto-generated structural content (always overwritten on generate)
+ * 3. references/data-semantics.md — AI-driven semantic guidance (always overwritten on generate)
+ *
+ * Template files live in builtin-skills/app-skill/ — static content is defined there,
+ * dynamic content (model tables, AI buttons) is filled in by code.
  */
 import { promises as fs } from 'fs';
 import path from 'path';
-// ── MCP Tool Generation ──
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// From dist/ → go up to package root → builtin-skills/app-skill/
+const TEMPLATES_DIR = path.resolve(__dirname, '../builtin-skills/app-skill');
+// ── Template Loading ──
+async function loadTemplate(relativePath) {
+    return fs.readFile(path.join(TEMPLATES_DIR, relativePath), 'utf-8');
+}
+// ── Dynamic Content Builders ──
 /**
- * Generate MCP server code from model schemas
+ * Build a markdown table row for a model field
  */
-function generateMcpToolForModel(model) {
-    const modelName = model.name;
-    const capitalName = modelName.split(/[-_]/).map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
-    const readParams = generateMcpParams(model, 'read');
-    const writeParams = generateMcpParams(model, 'write');
-    return `// Auto-generated by loom generate capabilities
-// Model: ${modelName}
-
-import { z } from 'zod';
-import type { DataAdapter } from '@loom-framework/core';
-
-const ${modelName}Schema = z.object({
-${model.fields.map(f => `  ${f.name}: ${fieldToZod(f)},`).join('\n')}
-});
-
-export function register${capitalName}Tools(
-  server: { tool: (name: string, description: string, schema: z.ZodObject<any>, handler: (params: any) => Promise<{ content: Array<{ type: string; text: string }> }>) => void },
-  adapter: DataAdapter
-) {
-  // read_${modelName}
-  server.tool(
-    'read_${modelName}',
-    'Read ${modelName} records${model.description ? ': ' + model.description : ''}',
-    z.object({
-      id: z.string().optional().describe('Record ID for single lookup'),
-      filter: z.record(z.unknown()).optional().describe('Filter conditions'),
-      limit: z.number().optional().describe('Max records to return'),
-    }),
-    async (params) => {
-      const result = await adapter.read('${modelName}', params);
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-      };
-    }
-  );
-
-  // write_${modelName}
-  server.tool(
-    'write_${modelName}',
-    'Create a new ${modelName} record',
-    ${modelName}Schema,
-    async (params) => {
-      const result = await adapter.write('${modelName}', params);
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-      };
-    }
-  );
-
-  // update_${modelName}
-  server.tool(
-    'update_${modelName}',
-    'Update an existing ${modelName} record',
-    z.object({
-      id: z.string().describe('Record ID to update'),
-      data: ${modelName}Schema.partial().describe('Fields to update'),
-    }),
-    async (params) => {
-      const result = await adapter.update('${modelName}', params.id, params.data);
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
-      };
-    }
-  );
-
-  // delete_${modelName}
-  server.tool(
-    'delete_${modelName}',
-    'Delete a ${modelName} record',
-    z.object({
-      id: z.string().describe('Record ID to delete'),
-    }),
-    async (params) => {
-      await adapter.delete('${modelName}', params.id);
-      return {
-        content: [{ type: 'text', text: \`Deleted ${modelName} record: \${params.id}\` }],
-      };
-    }
-  );
-}`;
-}
-function fieldToZod(field) {
-    const base = (() => {
-        switch (field.type) {
-            case 'string': return 'z.string()';
-            case 'number': return 'z.number()';
-            case 'boolean': return 'z.boolean()';
-            case 'date': return 'z.string().describe("ISO date string")';
-            case 'string[]': return 'z.array(z.string())';
-            case 'number[]': return 'z.array(z.number())';
-            case 'json': return 'z.unknown()';
-        }
-    })();
-    const withDesc = field.description ? `${base}.describe("${field.description}")` : base;
-    const withEnum = field.enum ? `z.enum([${field.enum.map(e => `"${e}"`).join(', ')}])` : withDesc;
-    const withRequired = field.required ? withEnum : `${withEnum}.optional()`;
-    return withRequired;
-}
-function generateMcpParams(model, operation) {
-    if (operation === 'read') {
-        return `{ id?: string, filter?: Record<string, unknown>, limit?: number }`;
-    }
-    return `{\n${model.fields.map(f => `  ${f.name}: ${f.type}${f.required ? '' : '?'},`).join('\n')}\n}`;
+function fieldTableRow(f) {
+    const req = f.required ? 'yes' : 'no';
+    const enums = f.enum ? ` (${f.enum.join('/')})` : '';
+    const def = f.default !== undefined ? ` [default: ${JSON.stringify(f.default)}]` : '';
+    const desc = (f.description || '') + enums + def;
+    return `| ${f.name} | ${f.type} | ${req} | ${desc} |`;
 }
 /**
- * Generate MCP Server index.ts
+ * Build the Data Models section content
  */
-function generateMcpServerIndex(models) {
-    const imports = models.map(m => {
-        const capitalName = m.name.split(/[-_]/).map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
-        return `import { register${capitalName}Tools } from './tools/${m.name}.js';`;
-    }).join('\n');
-    const registrations = models.map(m => {
-        const capitalName = m.name.split(/[-_]/).map(s => s.charAt(0).toUpperCase() + s.slice(1)).join('');
-        return `  register${capitalName}Tools(server, adapter);`;
-    }).join('\n');
-    return `// Auto-generated by loom generate capabilities
-// Loom MCP Server - Data Access Layer
-
-import path from 'path';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { FileSystemAdapter } from '@loom-framework/core';
-import { loadConfig } from '@loom-framework/core';
-${imports}
-
-async function main() {
-  const projectRoot = process.env.LOOM_PROJECT_ROOT || process.cwd();
-  const config = await loadConfig(projectRoot);
-  const adapter = new FileSystemAdapter({
-    dataDir: process.env.LOOM_DATA_DIR || path.join(projectRoot, 'data'),
-    config,
-  });
-  await adapter.initialize();
-
-  const server = new McpServer({
-    name: 'loom-data',
-    version: '1.0.0',
-  });
-
-${registrations}
-
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);
-`;
+function buildDataModelsSection(models) {
+    return models.map(model => {
+        const header = `### ${model.name}${model.description ? ` — ${model.description}` : ''}`;
+        const tableHeader = '| Field | Type | Required | Description |';
+        const tableSep = '|-------|------|----------|-------------|';
+        const tableRows = model.fields.map(fieldTableRow).join('\n');
+        return `${header}\n\n${tableHeader}\n${tableSep}\n${tableRows}`;
+    }).join('\n\n');
 }
 /**
- * Generate .loom/mcp.json
+ * Build the AI Buttons section content (or empty string if none)
  */
-function generateMcpJson(projectRoot) {
-    return JSON.stringify({
-        mcpServers: {
-            'loom-data': {
-                command: 'npx',
-                args: ['tsx', '.loom/mcp-server/index.ts'],
-                env: {
-                    LOOM_PROJECT_ROOT: projectRoot,
-                    LOOM_DATA_DIR: './data',
-                },
-            },
-        },
-    }, null, 2);
+function buildAiButtonsSection(aiButtons) {
+    if (!aiButtons || aiButtons.length === 0)
+        return '';
+    return `## AI Buttons\n\n${aiButtons.map(btn => {
+        const placement = btn.placement ? ` (available on: ${btn.placement})` : ' (available on all pages)';
+        return `- **${btn.id}** ("${btn.label}"): \`${btn.prompt}\`${placement}`;
+    }).join('\n')}`;
 }
-// ── CLI Command Generation ──
 /**
- * Generate CLI data command for a model
+ * Build the model names line for data-semantics.md (or empty string if only one model)
  */
-function generateCliDataCommand(model) {
-    const modelName = model.name;
-    return `// Auto-generated by loom generate capabilities
-// Model: ${modelName}
-
-import { defineCommand } from '@loom-framework/core';
-
-export default defineCommand({
-  name: 'data:read:${modelName}',
-  description: 'Read ${modelName} records${model.description ? ' - ' + model.description : ''}',
-  options: {
-    id: { type: 'string', description: 'Record ID for single lookup' },
-    filter: { type: 'json', description: 'Filter conditions as JSON' },
-    limit: { type: 'number', description: 'Max records to return' },
-  },
-  async execute(args, context) {
-    const adapter = context.getDataAdapter();
-    const result = await adapter.read('${modelName}', {
-      id: args.id as string | undefined,
-      filter: args.filter as Record<string, unknown> | undefined,
-      limit: args.limit as number | undefined,
-    });
-    return JSON.stringify(result, null, 2);
-  },
-});
-`;
+function buildModelNamesLine(models) {
+    if (models.length <= 1)
+        return '';
+    return `\nModels in this project: ${models.map(m => `\`${m.name}\``).join(', ')}.`;
 }
 /**
- * Generate all capabilities from config
+ * Generate all capabilities from config.
+ *
+ * Three-file strategy:
+ * - SKILL.md: natural language content (only created if not exists, never overwritten)
+ * - references/models.md: structural content (always regenerated)
+ * - references/data-semantics.md: semantic guidance (always regenerated)
  */
 export async function generateCapabilities(projectRoot, config) {
-    const loomDir = path.join(projectRoot, '.loom');
-    const mcpServerDir = path.join(loomDir, 'mcp-server');
-    const mcpToolsDir = path.join(mcpServerDir, 'tools');
-    const cliDataDir = path.join(projectRoot, 'cli', 'src', 'commands', 'data');
+    const projectName = config.project.name;
+    const models = config.data.models;
+    const skillDir = path.join(projectRoot, '.claude', 'skills', projectName);
+    const skillPromptFile = path.join(skillDir, 'SKILL.md');
+    const referencesDir = path.join(skillDir, 'references');
+    const modelsFile = path.join(referencesDir, 'models.md');
+    const dataSemanticsFile = path.join(referencesDir, 'data-semantics.md');
     const filesWritten = [];
-    // Clean and create directories
-    await fs.mkdir(mcpToolsDir, { recursive: true });
-    await fs.mkdir(cliDataDir, { recursive: true });
-    // Generate MCP tools for each model
-    for (const model of config.data.models) {
-        // MCP tool file
-        const mcpToolPath = path.join(mcpToolsDir, `${model.name}.ts`);
-        await fs.writeFile(mcpToolPath, generateMcpToolForModel(model), 'utf-8');
-        filesWritten.push(mcpToolPath);
-        // CLI data command
-        const cliCmdPath = path.join(cliDataDir, `${model.name}.ts`);
-        await fs.writeFile(cliCmdPath, generateCliDataCommand(model), 'utf-8');
-        filesWritten.push(cliCmdPath);
+    // Create skill directory structure
+    await fs.mkdir(referencesDir, { recursive: true });
+    // Load templates in parallel
+    const [skillTemplate, modelsTemplate, semanticsTemplate] = await Promise.all([
+        loadTemplate('SKILL.md'),
+        loadTemplate('references/models.md'),
+        loadTemplate('references/data-semantics.md'),
+    ]);
+    // SKILL.md: apply variable substitution, only write if not exists
+    const skillExists = await fs.access(skillPromptFile).then(() => true, () => false);
+    if (!skillExists) {
+        const skillContent = skillTemplate
+            .replace(/\{\{projectName\}\}/g, projectName);
+        await fs.writeFile(skillPromptFile, skillContent, 'utf-8');
+        filesWritten.push(skillPromptFile);
     }
-    // Generate MCP Server index
-    const indexPath = path.join(mcpServerDir, 'index.ts');
-    await fs.writeFile(indexPath, generateMcpServerIndex(config.data.models), 'utf-8');
-    filesWritten.push(indexPath);
-    // Generate MCP Server package.json
-    // Note: @loom-framework/core is resolved from parent project's node_modules at runtime (via tsx)
-    const mcpPkgPath = path.join(mcpServerDir, 'package.json');
-    await fs.writeFile(mcpPkgPath, JSON.stringify({
-        name: 'loom-mcp-server',
-        version: '1.0.0',
-        type: 'module',
-        main: 'index.js',
-        dependencies: {
-            '@modelcontextprotocol/sdk': '^1.12.0',
-            '@loom-framework/core': '^0.1.0',
-            'zod': '^3.23.0',
-        },
-        devDependencies: {
-            '@types/node': '^22.0.0',
-            'tsx': '^4.7.0',
-            'typescript': '^5.6.0',
-        },
-    }, null, 2), 'utf-8');
-    filesWritten.push(mcpPkgPath);
-    // Generate MCP Server tsconfig (self-contained, no external extends)
-    const mcpTsconfigPath = path.join(mcpServerDir, 'tsconfig.json');
-    await fs.writeFile(mcpTsconfigPath, JSON.stringify({
-        compilerOptions: {
-            target: 'ES2022',
-            module: 'Node16',
-            moduleResolution: 'Node16',
-            lib: ['ES2022'],
-            strict: true,
-            esModuleInterop: true,
-            skipLibCheck: true,
-            forceConsistentCasingInFileNames: true,
-            resolveJsonModule: true,
-            declaration: true,
-            sourceMap: true,
-            outDir: '.',
-            rootDir: '.',
-        },
-        include: ['*.ts', 'tools/*.ts'],
-    }, null, 2), 'utf-8');
-    filesWritten.push(mcpTsconfigPath);
-    // Generate mcp.json
-    const mcpJsonPath = path.join(loomDir, 'mcp.json');
-    await fs.writeFile(mcpJsonPath, generateMcpJson(projectRoot), 'utf-8');
-    filesWritten.push(mcpJsonPath);
-    return { mcpServerDir, filesWritten };
+    // references/models.md: fill dynamic sections into template
+    const dataModelsSection = buildDataModelsSection(models);
+    const aiButtonsSection = buildAiButtonsSection(config.aiButtons);
+    const modelsContent = modelsTemplate
+        .replace('<!-- DATA_MODELS -->', dataModelsSection)
+        .replace('<!-- AI_BUTTONS -->', aiButtonsSection ? '\n' + aiButtonsSection + '\n' : '');
+    await fs.writeFile(modelsFile, modelsContent, 'utf-8');
+    filesWritten.push(modelsFile);
+    // references/data-semantics.md: fill model names line into template
+    const modelNamesLine = buildModelNamesLine(models);
+    const semanticsContent = semanticsTemplate
+        .replace('<!-- MODEL_NAMES -->', modelNamesLine);
+    await fs.writeFile(dataSemanticsFile, semanticsContent, 'utf-8');
+    filesWritten.push(dataSemanticsFile);
+    return { skillDir, skillPromptFile, modelsFile, dataSemanticsFile, filesWritten };
 }
 //# sourceMappingURL=capability-generator.js.map

package/dist/capability-generator.js.map

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

package/dist/cli/commands/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * loom auth - Authentication commands
+ *
+ * loom auth login    - Login and print access token
+ * loom auth register - Register a new user (admin only)
+ * loom auth logout   - Logout (revoke refresh token on server)
+ * loom auth whoami   - Show current user info
+ */
+import type { Command } from 'commander';
+export declare function registerAuthCommand(program: Command): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/cli/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyK1D"}

package/dist/cli/commands/auth.js

@@ -0,0 +1,211 @@
+/**
+ * loom auth - Authentication commands
+ *
+ * loom auth login    - Login and print access token
+ * loom auth register - Register a new user (admin only)
+ * loom auth logout   - Logout (revoke refresh token on server)
+ * loom auth whoami   - Show current user info
+ */
+import chalk from 'chalk';
+import { resolveToken, resolveServer, requireToken, CliAuthError } from '../helpers/auth-client.js';
+export function registerAuthCommand(program) {
+    const auth = program
+        .command('auth')
+        .description('Authentication operations');
+    // loom auth login
+    auth
+        .command('login')
+        .description('Login and print access token')
+        .option('-u, --username <username>', 'Username')
+        .option('-p, --password <password>', 'Password')
+        .option('--server <url>', 'Server URL')
+        .action(async (options) => {
+        try {
+            const server = resolveServer(options.server);
+            const username = options.username || await promptInput('Username: ');
+            const password = options.password || await promptInput('Password: ', true);
+            const response = await fetch(`${server}/api/v1/auth/login`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ username, password }),
+            });
+            if (!response.ok) {
+                const data = await response.json();
+                console.error(chalk.red('Login failed:'), data.error || response.statusText);
+                process.exit(1);
+            }
+            const data = await response.json();
+            console.log(chalk.green(`Logged in as ${data.user.username} (role: ${data.user.role})`));
+            console.log();
+            console.log(chalk.bold('Access token:'));
+            console.log(chalk.cyan(data.accessToken));
+            console.log();
+            console.log(chalk.dim('Use this token in other commands:'));
+            console.log(chalk.dim(`  loom data read <model> --token ${data.accessToken}`));
+            console.log(chalk.dim('Or set environment variable:'));
+            console.log(chalk.dim(`  export LOOM_TOKEN=${data.accessToken}`));
+        }
+        catch (err) {
+            if (err instanceof CliAuthError) {
+                console.error(chalk.red(err.message));
+                process.exit(1);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Login failed:'), message);
+            process.exit(1);
+        }
+    });
+    // loom auth register
+    auth
+        .command('register')
+        .description('Register a new user (admin only)')
+        .option('-u, --username <username>', 'Username')
+        .option('-p, --password <password>', 'Password')
+        .option('-r, --role <role>', 'Role')
+        .option('--token <token>', 'Auth token (admin)')
+        .option('--server <url>', 'Server URL')
+        .action(async (options) => {
+        try {
+            const server = resolveServer(options.server);
+            const username = options.username || await promptInput('Username: ');
+            const password = options.password || await promptInput('Password: ', true);
+            const headers = { 'Content-Type': 'application/json' };
+            // Resolve token for admin auth
+            const token = resolveToken(options.token);
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            const response = await fetch(`${server}/api/v1/auth/register`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ username, password, role: options.role }),
+            });
+            if (!response.ok) {
+                const data = await response.json();
+                console.error(chalk.red('Registration failed:'), data.error || response.statusText);
+                process.exit(1);
+            }
+            const data = await response.json();
+            console.log(chalk.green(`User created: ${data.user.username} (role: ${data.user.role})`));
+            if (data.serviceToken) {
+                console.log();
+                console.log(chalk.bold('Service token (for Process automation):'));
+                console.log(chalk.cyan(data.serviceToken));
+                console.log(chalk.dim('Store this token securely — it will not be shown again.'));
+            }
+        }
+        catch (err) {
+            if (err instanceof CliAuthError) {
+                console.error(chalk.red(err.message));
+                process.exit(1);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Registration failed:'), message);
+            process.exit(1);
+        }
+    });
+    // loom auth logout
+    auth
+        .command('logout')
+        .description('Logout (revoke refresh token on server)')
+        .requiredOption('--refresh-token <token>', 'Refresh token to revoke')
+        .option('--token <token>', 'Auth token')
+        .option('--server <url>', 'Server URL')
+        .action(async (options) => {
+        try {
+            const server = resolveServer(options.server);
+            const headers = { 'Content-Type': 'application/json' };
+            const token = resolveToken(options.token);
+            if (token)
+                headers.Authorization = `Bearer ${token}`;
+            const response = await fetch(`${server}/api/v1/auth/logout`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ refreshToken: options.refreshToken }),
+            });
+            if (!response.ok) {
+                const data = await response.json();
+                console.error(chalk.red('Logout failed:'), data.error || response.statusText);
+                process.exit(1);
+            }
+            console.log(chalk.green('Logged out'));
+        }
+        catch (err) {
+            if (err instanceof CliAuthError) {
+                console.error(chalk.red(err.message));
+                process.exit(1);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Logout failed:'), message);
+            process.exit(1);
+        }
+    });
+    // loom auth whoami
+    auth
+        .command('whoami')
+        .description('Show current user info')
+        .option('--token <token>', 'Auth token')
+        .option('--server <url>', 'Server URL')
+        .action(async (options) => {
+        try {
+            const server = resolveServer(options.server);
+            const token = requireToken(options.token);
+            const response = await fetch(`${server}/api/v1/auth/whoami`, {
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            if (!response.ok) {
+                const data = await response.json();
+                console.error(chalk.red('Whoami failed:'), data.error || response.statusText);
+                process.exit(1);
+            }
+            const data = await response.json();
+            console.log(chalk.bold(`User: ${data.user.username}`));
+            console.log(`  ID: ${data.user.userId}`);
+            console.log(`  Role: ${data.user.role}`);
+        }
+        catch (err) {
+            if (err instanceof CliAuthError) {
+                console.error(chalk.red(err.message));
+                process.exit(1);
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Whoami failed:'), message);
+            process.exit(1);
+        }
+    });
+}
+async function promptInput(prompt, hidden = false) {
+    const { createInterface } = await import('readline');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        if (hidden) {
+            const stdin = process.stdin;
+            const onData = (char) => {
+                const str = char.toString();
+                if (str === '\n' || str === '\r') {
+                    stdin.removeListener('data', onData);
+                }
+                else if (str === '\u0003') {
+                    process.exit();
+                }
+                else {
+                    process.stdout.clearLine(0);
+                    process.stdout.cursorTo(0);
+                    process.stdout.write(prompt);
+                }
+            };
+            rl.question(prompt, (answer) => {
+                process.stdout.write('\n');
+                rl.close();
+                resolve(answer);
+            });
+            stdin.on('data', onData);
+        }
+        else {
+            rl.question(prompt, (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map