serverless-ircd 0.1.0 → 0.3.0

package/packages/irc-core/tests/caps/capabilities.test.ts

@@ -18,6 +18,7 @@ describe('SUPPORTED_CAPABILITIES', () => {
         'away-notify',
         'batch',
         'chghost',
+        'draft/chathistory',
         'echo-message',
         'extended-join',
         'invite-notify',
@@ -73,6 +74,10 @@ describe('isSupportedCap', () => {
     expect(isSupportedCap('safelist')).toBe(true);
   });
 
+  it('returns true for draft/chathistory (bare name, no value)', () => {
+    expect(isSupportedCap('draft/chathistory')).toBe(true);
+  });
+
   it('returns false for an unknown cap name', () => {
     expect(isSupportedCap('does-not-exist')).toBe(false);
   });
@@ -111,6 +116,23 @@ describe('getLsString', () => {
   });
 });
 
+describe('draft/chathistory advertisement', () => {
+  it('is advertised as a bare name (no value parameter)', () => {
+    const cap = SUPPORTED_CAPABILITIES.find((c) => c.name === 'draft/chathistory');
+    expect(cap).toBeDefined();
+    expect(cap?.value).toBeUndefined();
+  });
+
+  it('appears in CAP LS output as the bare token', () => {
+    expect(getLsString()).toContain('draft/chathistory');
+    expect(getLsString()).not.toContain('draft/chathistory=');
+  });
+
+  it('is ACKable via SUPPORTED_CAP_NAMES membership (CAP REQ round-trip)', () => {
+    expect(SUPPORTED_CAP_NAMES.has('draft/chathistory')).toBe(true);
+  });
+});
+
 describe('splitCapsForWire', () => {
   it('returns a single chunk when everything fits', () => {
     const tokens = ['a', 'b', 'c'];

package/packages/irc-core/tests/case-fold.test.ts

@@ -0,0 +1,80 @@
+import fc from 'fast-check';
+import { describe, expect, it } from 'vitest';
+import { type CaseMapping, caseFold } from '../src/case-fold';
+
+// ============================================================================
+// caseFold — rfc1459 special-character folding
+// ============================================================================
+
+describe('caseFold — rfc1459', () => {
+  it('folds [Foo] to {foo}', () => {
+    expect(caseFold('rfc1459', '[Foo]')).toBe('{foo}');
+  });
+
+  it('folds uppercase A–Z to a–z', () => {
+    expect(caseFold('rfc1459', 'ABCXYZ')).toBe('abcxyz');
+  });
+
+  it('folds the four rfc1459 specials [ \\ ] ^ to { | } ~', () => {
+    expect(caseFold('rfc1459', '[\\]^')).toBe('{|}~');
+  });
+
+  it('does not fold { | } ~ any further', () => {
+    expect(caseFold('rfc1459', '{|}~')).toBe('{|}~');
+  });
+
+  it('leaves non-folding characters unchanged', () => {
+    expect(caseFold('rfc1459', 'a1_-.#@')).toBe('a1_-.#@');
+  });
+
+  it('returns the empty string unchanged', () => {
+    expect(caseFold('rfc1459', '')).toBe('');
+  });
+});
+
+// ============================================================================
+// caseFold — ascii mapping (strict subset of rfc1459)
+// ============================================================================
+
+describe('caseFold — ascii', () => {
+  it('folds uppercase A–Z to a–z', () => {
+    expect(caseFold('ascii', 'ABCXYZ')).toBe('abcxyz');
+  });
+
+  it('does NOT fold the rfc1459 specials [ \\ ] ^', () => {
+    expect(caseFold('ascii', '[Foo]')).toBe('[foo]');
+  });
+
+  it('leaves non-folding characters unchanged', () => {
+    expect(caseFold('ascii', 'a1_-.#[]')).toBe('a1_-.#[]');
+  });
+});
+
+// ============================================================================
+// caseFold — idempotency (property test)
+// ============================================================================
+
+describe('caseFold — idempotency', () => {
+  const mappings: CaseMapping[] = ['rfc1459', 'ascii'];
+
+  for (const mapping of mappings) {
+    it(`fold(fold(s)) === fold(s) under ${mapping}`, () => {
+      const nickish = fc.stringMatching(/[\x21-\x7e]{0,16}/u);
+      fc.assert(
+        fc.property(nickish, (s) => {
+          const once = caseFold(mapping, s);
+          expect(caseFold(mapping, once)).toBe(once);
+        }),
+      );
+    });
+  }
+
+  it('rfc1459 and ascii agree on pure A–Z / a–z input', () => {
+    const alpha = fc.stringMatching(/^[A-Za-z]{1,16}$/u);
+    fc.assert(
+      fc.property(alpha, (s) => {
+        expect(caseFold('rfc1459', s)).toBe(caseFold('ascii', s));
+      }),
+    );
+  });
+});

package/packages/irc-core/tests/cloak.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, it } from 'vitest';
+import { cloakHost } from '../src/cloak';
+
+// ============================================================================
+// cloakHost — basic deterministic cloaking
+// ============================================================================
+
+describe('cloakHost — determinism', () => {
+  it('returns the same cloak for the same IP + secret', () => {
+    const a = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    const b = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    expect(a).toBe(b);
+  });
+
+  it('returns different cloaks for different IPs with the same secret', () => {
+    const a = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    const b = cloakHost('198.51.100.7', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    expect(a).not.toBe(b);
+  });
+
+  it('returns different cloaks for the same IP with different secrets', () => {
+    const a = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    const b = cloakHost('203.0.113.5', { enabled: true, secret: 'other' }, 'irc.example.com');
+    expect(a).not.toBe(b);
+  });
+});
+
+// ============================================================================
+// cloakHost — format
+// ============================================================================
+
+describe('cloakHost — format', () => {
+  it('produces a cloak ending in the configured suffix', () => {
+    const cloak = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    expect(cloak.endsWith('.irc.example.com')).toBe(true);
+  });
+
+  it('produces a cloak whose leading segment is a stable hex-encoded hash', () => {
+    const cloak = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    // Strip the suffix, leaving just the hash segment.
+    const segment = cloak.slice(0, cloak.indexOf('.'));
+    expect(segment).toMatch(/^[a-z0-9]+$/u);
+    expect(segment.length).toBeGreaterThanOrEqual(8);
+  });
+
+  it('produces a cloak no longer than 63 bytes per label (DNS limit)', () => {
+    const cloak = cloakHost('203.0.113.5', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    for (const label of cloak.split('.')) {
+      expect(label.length).toBeLessThanOrEqual(63);
+    }
+  });
+});
+
+// ============================================================================
+// cloakHost — disabled
+// ============================================================================
+
+describe('cloakHost — disabled', () => {
+  it('returns the original host when cloaking is disabled', () => {
+    const cloak = cloakHost('203.0.113.5', { enabled: false, secret: 's3cret' }, 'irc.example.com');
+    expect(cloak).toBe('203.0.113.5');
+  });
+});
+
+// ============================================================================
+// cloakHost — IPv6
+// ============================================================================
+
+describe('cloakHost — IPv6', () => {
+  it('cloaks an IPv6 address the same way as an IPv4 address', () => {
+    const cloak = cloakHost('2001:db8::1', { enabled: true, secret: 's3cret' }, 'irc.example.com');
+    expect(cloak.endsWith('.irc.example.com')).toBe(true);
+    // Re-cloaking deterministically yields the same value.
+    expect(cloakHost('2001:db8::1', { enabled: true, secret: 's3cret' }, 'irc.example.com')).toBe(
+      cloak,
+    );
+  });
+});