toiljs 0.0.115 → 0.0.117

package/test/auth-emails.test.ts

@@ -1,118 +0,0 @@
-/**
- * The built-in auth email OVERRIDE codegen (src/compiler/auth-emails.ts): the
- * pure fold (a rendered emails/auth-*.tsx over the default) and the AssemblyScript
- * `AuthEmail` module it bakes. The Vite-render + file IO in `renderAuthEmails` is
- * covered by the example build; here we test the string transforms in isolation.
- */
-import { describe, expect, it } from 'vitest';
-
-import { __test } from '../src/compiler/auth-emails';
-import type { RenderedEmail } from '../src/compiler/emails';
-
-const { moduleSource, effectiveFromOverride, SPECS } = __test;
-
-/** A defaults-only parts map (what a project with no overrides generates). */
-function defaultParts(): Record<string, { subject: string; text: string; html: string }> {
-    const parts: Record<string, { subject: string; text: string; html: string }> = {};
-    for (const [name, spec] of Object.entries(SPECS))
-        parts[name] = {
-            subject: spec.defaultSubject,
-            text: spec.defaultText,
-            html: spec.defaultHtml,
-        };
-    return parts;
-}
-
-function rendered(name: string, over: Partial<RenderedEmail>): RenderedEmail {
-    return {
-        name,
-        subject: over.subject ?? name,
-        html: over.html ?? '',
-        text: over.text ?? '',
-        tokens: over.tokens ?? [],
-        purpose: over.purpose ?? name.toLowerCase(),
-    };
-}
-
-describe('AuthEmail module codegen', () => {
-    it('emits confirm/reset/twofa, each through the DETACHED send with its purpose', () => {
-        const src = moduleSource(defaultParts());
-        expect(src).toContain('export namespace AuthEmail {');
-        expect(src).toContain('export function confirm(to: string, link: string): void');
-        expect(src).toContain('export function reset(to: string, link: string): void');
-        // twofa takes the subject as a runtime arg (login vs setup), not baked.
-        expect(src).toContain(
-            'export function twofa(to: string, code: string, subject: string, action: string): void',
-        );
-        // Every send is detached (the anti-enumeration property), never the suspending send.
-        expect(src.match(/\.sendDetached\(/g)).toHaveLength(3);
-        expect(src).not.toContain('.send(to');
-        expect(src).toContain('"verify"');
-        expect(src).toContain('"reset"');
-        expect(src).toContain('"2fa"');
-    });
-
-    it('bakes the default subject for confirm/reset but passes `subject` through for twofa', () => {
-        const src = moduleSource(defaultParts());
-        expect(src).toContain('new EmailTemplate("Confirm your account"');
-        expect(src).toContain('new EmailTemplate("Reset your password"');
-        expect(src).toContain('new EmailTemplate(subject,'); // twofa uses the arg
-    });
-
-    it('interpolates the right token per email (link for confirm/reset, code + action for twofa)', () => {
-        const src = moduleSource(defaultParts());
-        expect(src).toContain('v.set("link", link)');
-        expect(src).toContain('v.set("code", code)');
-        expect(src).toContain('v.set("action", action)');
-    });
-
-    it('escapes baked HTML into a valid string literal', () => {
-        const parts = defaultParts();
-        parts.AuthConfirm = {
-            subject: 'Hi "there"',
-            text: 'a\nb',
-            html: '<a href="x">c</a>',
-        };
-        const src = moduleSource(parts);
-        // JSON.stringify escaping keeps the emitted AS parseable (quotes/newlines escaped).
-        expect(src).toContain('"Hi \\"there\\""');
-        expect(src).toContain('"<a href=\\"x\\">c</a>"');
-    });
-});
-
-describe('effectiveFromOverride', () => {
-    it('uses the override subject/text/html when the template sets a subject', () => {
-        const eff = effectiveFromOverride(
-            'AuthConfirm',
-            SPECS.AuthConfirm,
-            rendered('AuthConfirm', {
-                subject: 'Verify your Acme account',
-                html: '<p>{{link}}</p>',
-                text: '{{link}}',
-                tokens: ['link'],
-            }),
-        );
-        expect(eff.subject).toBe('Verify your Acme account');
-        expect(eff.html).toBe('<p>{{link}}</p>');
-    });
-
-    it('falls back to the default subject when the template did not set one', () => {
-        // renderModule defaults `subject` to the module name when no `export const subject`.
-        const eff = effectiveFromOverride(
-            'AuthConfirm',
-            SPECS.AuthConfirm,
-            rendered('AuthConfirm', { subject: 'AuthConfirm', html: '<p>{{link}}</p>', tokens: ['link'] }),
-        );
-        expect(eff.subject).toBe('Confirm your account');
-    });
-
-    it('ignores an override subject for twofa (login/setup subject is contextual)', () => {
-        const eff = effectiveFromOverride(
-            'Auth2fa',
-            SPECS.Auth2fa,
-            rendered('Auth2fa', { subject: 'ignored', html: '<b>{{code}}</b>', tokens: ['code'] }),
-        );
-        expect(eff.subject).toBe(''); // subjectFromArg: baked subject stays empty (the arg wins at runtime)
-        expect(eff.html).toBe('<b>{{code}}</b>');
-    });
-});

package/test/built-ssr.test.ts

@@ -1,148 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-import { describe, expect, it } from 'vitest';
-
-import { loadBuiltSsrTemplates } from '../src/devserver/production';
-import { assembleSsr, type SsrRoute } from '../src/devserver/ssr';
-
-function slotsManifest(tmplLen: number, hash: Buffer): Buffer {
-    const buf = Buffer.alloc(46 + 8);
-    let o = 0;
-    buf.write('TSLT', o, 'ascii');
-    o += 4;
-    buf.writeUInt16LE(1, o);
-    o += 2;
-    buf.writeUInt16LE(0, o);
-    o += 2;
-    buf.writeUInt32LE(tmplLen, o);
-    o += 4;
-    hash.copy(buf, o);
-    o += 32;
-    buf.writeUInt16LE(1, o);
-    o += 2;
-    buf.writeUInt32LE(1, o); // insert after the first byte
-    o += 4;
-    buf.writeUInt16LE(0, o);
-    o += 2;
-    buf.writeUInt8(0, o); // text
-    o += 1;
-    buf.writeUInt8(0, o);
-    return buf;
-}
-
-function valuesEnvelope(hash: Buffer, value: string): Buffer {
-    const valueBytes = Buffer.from(value);
-    const buf = Buffer.alloc(2 + 32 + 2 + 2 + 2 + 1 + 4 + valueBytes.length);
-    let o = 0;
-    buf.writeUInt16LE(200, o);
-    o += 2;
-    hash.copy(buf, o);
-    o += 32;
-    buf.writeUInt16LE(0, o); // headers
-    o += 2;
-    buf.writeUInt16LE(1, o); // slots
-    o += 2;
-    buf.writeUInt16LE(0, o);
-    o += 2;
-    buf.writeUInt8(0, o);
-    o += 1;
-    buf.writeUInt32LE(valueBytes.length, o);
-    o += 4;
-    valueBytes.copy(buf, o);
-    return buf;
-}
-
-/** An envelope with one header (the internal SSR-title header) plus one text slot. */
-function envelopeWithTitle(hash: Buffer, value: string, title: string): Buffer {
-    const name = Buffer.from('x-toil-ssr-title');
-    const titleBytes = Buffer.from(title);
-    const valueBytes = Buffer.from(value);
-    const buf = Buffer.alloc(
-        2 + 32 + 2 + (2 + 2 + name.length + titleBytes.length) + 2 + (2 + 1 + 4 + valueBytes.length),
-    );
-    let o = 0;
-    buf.writeUInt16LE(200, o);
-    o += 2;
-    hash.copy(buf, o);
-    o += 32;
-    buf.writeUInt16LE(1, o); // 1 header
-    o += 2;
-    buf.writeUInt16LE(name.length, o);
-    o += 2;
-    buf.writeUInt16LE(titleBytes.length, o);
-    o += 2;
-    name.copy(buf, o);
-    o += name.length;
-    titleBytes.copy(buf, o);
-    o += titleBytes.length;
-    buf.writeUInt16LE(1, o); // 1 slot
-    o += 2;
-    buf.writeUInt16LE(0, o); // slot id 0
-    o += 2;
-    buf.writeUInt8(0, o); // text kind
-    o += 1;
-    buf.writeUInt32LE(valueBytes.length, o);
-    o += 4;
-    valueBytes.copy(buf, o);
-    return buf;
-}
-
-describe('built SSR templates', () => {
-    it('loads the built shell, including production CSS links, from _ssr artifacts', () => {
-        const root = fs.mkdtempSync(path.join(os.tmpdir(), 'toil-built-ssr-'));
-        try {
-            const dir = path.join(root, '_ssr');
-            fs.mkdirSync(dir, { recursive: true });
-            const tmpl = Buffer.from(
-                '<!doctype html><html><head><link rel="stylesheet" href="/css/style.css"></head><body>A</body></html>',
-            );
-            const hash = Buffer.alloc(32, 7);
-            fs.writeFileSync(
-                path.join(dir, 'templates.json'),
-                JSON.stringify([{ route: '/x', name: 'x', hash: hash.toString('hex') }]),
-            );
-            fs.writeFileSync(path.join(dir, 'x.tmpl'), tmpl);
-            fs.writeFileSync(path.join(dir, 'x.slots'), slotsManifest(tmpl.length, hash));
-
-            const templates = loadBuiltSsrTemplates(root);
-            expect(templates).toHaveLength(1);
-            expect(Buffer.from(templates[0]!.tmpl).toString('utf8')).toContain('/css/style.css');
-            expect(Buffer.from(templates[0]!.hash!).equals(hash)).toBe(true);
-            expect(templates[0]!.entries).toEqual([{ id: 0, offset: 1 }]);
-        } finally {
-            fs.rmSync(root, { recursive: true, force: true });
-        }
-    });
-
-    it('checks the deployed template hash before splicing production SSR values', () => {
-        const hash = Buffer.alloc(32, 1);
-        const route: SsrRoute = {
-            test: () => true,
-            tmpl: Buffer.from('ab'),
-            entries: [{ id: 0, offset: 1 }],
-            hash,
-        };
-
-        expect(Buffer.from(assembleSsr(route, valuesEnvelope(hash, 'X'))!.html).toString()).toBe(
-            'aXb',
-        );
-        expect(assembleSsr(route, valuesEnvelope(Buffer.alloc(32, 2), 'X'))).toBeNull();
-    });
-
-    it('replaces the <title> from a guest setTitle header, then strips the internal header', () => {
-        const hash = Buffer.alloc(32, 1);
-        const route: SsrRoute = {
-            test: () => true,
-            tmpl: Buffer.from('<title>Static</title>ab'),
-            entries: [{ id: 0, offset: 22 }],
-            hash,
-        };
-        const out = assembleSsr(route, envelopeWithTitle(hash, 'X', 'Dynamic'))!;
-        // the body slot is spliced AND the <title> is replaced with the guest's per-request value
-        expect(Buffer.from(out.html).toString()).toBe('<title>Dynamic</title>aXb');
-        // the internal header never reaches the client
-        expect(out.headers.some(([k]) => k.toLowerCase() === 'x-toil-ssr-title')).toBe(false);
-    });
-});

package/test/channel.test.ts

@@ -1,21 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { resolveChannelUrl } from '../src/client/channel/channel';
-
-describe('resolveChannelUrl', () => {
-    it('uses ws:// over http and the default /_toil path', () => {
-        expect(resolveChannelUrl(undefined, { protocol: 'http:', host: 'localhost:3000' })).toBe(
-            'ws://localhost:3000/_toil',
-        );
-    });
-
-    it('uses wss:// over https', () => {
-        expect(resolveChannelUrl('/_toil', { protocol: 'https:', host: 'app.example.com' })).toBe(
-            'wss://app.example.com/_toil',
-        );
-    });
-
-    it('normalizes a path without a leading slash', () => {
-        expect(resolveChannelUrl('live', { protocol: 'http:', host: 'h:1' })).toBe('ws://h:1/live');
-    });
-});

package/test/config-host-port.test.ts

@@ -1,59 +0,0 @@
-/**
- * loadConfig host/port resolution: the dev server AND the self-host (`toiljs start`)
- * bind to a host+port resolved with the precedence CLI flag > env (PORT/HOST) >
- * config (client.host/port) > default (127.0.0.1:3000). These lock that precedence
- * and the env parsing (a blank/garbage PORT must fall through, never bind to 0).
- */
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-import { afterEach, describe, expect, it } from 'vitest';
-
-import { loadConfig } from '../src/compiler/config.js';
-
-// An empty dir with no toil.config so loadConfig exercises the env/opts/default path.
-const emptyRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'toil-cfg-'));
-
-describe('loadConfig host/port precedence', () => {
-    const savedPort = process.env.PORT;
-    const savedHost = process.env.HOST;
-    afterEach(() => {
-        if (savedPort === undefined) delete process.env.PORT;
-        else process.env.PORT = savedPort;
-        if (savedHost === undefined) delete process.env.HOST;
-        else process.env.HOST = savedHost;
-    });
-
-    it('defaults to 127.0.0.1:3000 with no flag / env / config', async () => {
-        delete process.env.PORT;
-        delete process.env.HOST;
-        const cfg = await loadConfig({ root: emptyRoot });
-        expect(cfg.port).toBe(3000);
-        expect(cfg.host).toBe('127.0.0.1');
-    });
-
-    it('reads the PORT / HOST env vars', async () => {
-        process.env.PORT = '8080';
-        process.env.HOST = '0.0.0.0';
-        const cfg = await loadConfig({ root: emptyRoot });
-        expect(cfg.port).toBe(8080);
-        expect(cfg.host).toBe('0.0.0.0');
-    });
-
-    it('CLI opts win over env (CLI > env)', async () => {
-        process.env.PORT = '8080';
-        process.env.HOST = '0.0.0.0';
-        const cfg = await loadConfig({ root: emptyRoot, port: 4321, host: '192.168.1.5' });
-        expect(cfg.port).toBe(4321);
-        expect(cfg.host).toBe('192.168.1.5');
-    });
-
-    it('a blank / non-numeric PORT env falls through to the default (never binds to 0)', async () => {
-        process.env.PORT = '';
-        delete process.env.HOST;
-        expect((await loadConfig({ root: emptyRoot })).port).toBe(3000);
-        process.env.PORT = 'not-a-number';
-        expect((await loadConfig({ root: emptyRoot })).port).toBe(3000);
-    });
-});

package/test/configure.test.ts

@@ -1,94 +0,0 @@
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-
-import { applyConfigure } from '../src/cli/configure';
-import type { StyleFeatures } from '../src/cli/features';
-
-const CSS: StyleFeatures = { preprocessor: 'css', tailwind: false };
-const SASS_TW: StyleFeatures = { preprocessor: 'sass', tailwind: true };
-
-const ENTRY = [
-    "import { routes, layout, notFound } from 'toiljs/routes';",
-    '',
-    "import './styles/main.css';",
-    '',
-    'Toil.mount(routes, layout, notFound);',
-    '',
-].join('\n');
-
-let dir: string;
-let clientDir: string;
-let pkgPath: string;
-
-async function readJson(p: string): Promise<{ devDependencies?: Record<string, string> }> {
-    return JSON.parse(await fs.readFile(p, 'utf8')) as { devDependencies?: Record<string, string> };
-}
-
-async function exists(p: string): Promise<boolean> {
-    try {
-        await fs.access(p);
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-beforeEach(async () => {
-    dir = await fs.mkdtemp(path.join(os.tmpdir(), 'toil-cfg-'));
-    clientDir = path.join(dir, 'client');
-    pkgPath = path.join(dir, 'package.json');
-    await fs.mkdir(path.join(clientDir, 'styles'), { recursive: true });
-    await fs.writeFile(path.join(clientDir, 'toil.tsx'), ENTRY, 'utf8');
-    await fs.writeFile(path.join(clientDir, 'styles/main.css'), 'body { margin: 0; }\n', 'utf8');
-    await fs.writeFile(
-        pkgPath,
-        JSON.stringify({ devDependencies: { typescript: '^6' } }, null, 4),
-        'utf8',
-    );
-});
-
-afterEach(async () => {
-    await fs.rm(dir, { recursive: true, force: true });
-});
-
-describe('applyConfigure', () => {
-    it('adds Sass + Tailwind: renames stylesheet, adds entry + imports + deps', async () => {
-        const pkg = await readJson(pkgPath);
-        await applyConfigure(clientDir, pkgPath, pkg, CSS, SASS_TW);
-
-        expect(await exists(path.join(clientDir, 'styles/main.scss'))).toBe(true);
-        expect(await exists(path.join(clientDir, 'styles/main.css'))).toBe(false);
-        expect(await exists(path.join(clientDir, 'styles/tailwind.css'))).toBe(true);
-
-        const entry = await fs.readFile(path.join(clientDir, 'toil.tsx'), 'utf8');
-        expect(entry).toContain("import './styles/tailwind.css';");
-        expect(entry).toContain("import './styles/main.scss';");
-        expect(entry).not.toContain('main.css');
-        expect(entry).toContain('Toil.mount(routes, layout, notFound);');
-
-        const deps = (await readJson(pkgPath)).devDependencies ?? {};
-        expect(deps).toHaveProperty('sass');
-        expect(deps).toHaveProperty('tailwindcss');
-        expect(deps).toHaveProperty('@tailwindcss/vite');
-    });
-
-    it('removes everything cleanly when switching back to plain CSS', async () => {
-        const pkg = await readJson(pkgPath);
-        await applyConfigure(clientDir, pkgPath, pkg, CSS, SASS_TW);
-        const mid = await readJson(pkgPath);
-        await applyConfigure(clientDir, pkgPath, mid, SASS_TW, CSS);
-
-        expect(await exists(path.join(clientDir, 'styles/main.css'))).toBe(true);
-        expect(await exists(path.join(clientDir, 'styles/main.scss'))).toBe(false);
-        expect(await exists(path.join(clientDir, 'styles/tailwind.css'))).toBe(false);
-
-        const deps = (await readJson(pkgPath)).devDependencies ?? {};
-        expect(deps).not.toHaveProperty('sass');
-        expect(deps).not.toHaveProperty('tailwindcss');
-        expect(deps).not.toHaveProperty('@tailwindcss/vite');
-        expect(deps).toHaveProperty('typescript');
-    });
-});