feat: add fluxer upstream source and self-hosting documentation
- Clone of github.com/fluxerapp/fluxer (official upstream) - SELF_HOSTING.md: full VM rebuild procedure, architecture overview, service reference, step-by-step setup, troubleshooting, seattle reference - dev/.env.example: all env vars with secrets redacted and generation instructions - dev/livekit.yaml: LiveKit config template with placeholder keys - fluxer-seattle/: existing seattle deployment setup scripts
This commit is contained in:
Vish
131
fluxer/packages/limits/src/__tests__/LimitDiffer.test.tsx
Normal file
131
fluxer/packages/limits/src/__tests__/LimitDiffer.test.tsx
Normal file
@@ -0,0 +1,131 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import {DEFAULT_FREE_LIMITS, DEFAULT_PREMIUM_LIMITS} from '@fluxer/limits/src/LimitDefaults';
|
||||
import {computeOverrides, computeWireFormat, expandWireFormat} from '@fluxer/limits/src/LimitDiffer';
|
||||
import type {LimitConfigSnapshot} from '@fluxer/limits/src/LimitTypes';
|
||||
import {describe, expect, test} from 'vitest';
|
||||
|
||||
describe('LimitDiffer', () => {
|
||||
test('computeOverrides returns empty object when limits match defaults', () => {
|
||||
const overrides = computeOverrides(DEFAULT_FREE_LIMITS, DEFAULT_FREE_LIMITS);
|
||||
expect(overrides).toEqual({});
|
||||
});
|
||||
|
||||
test('computeOverrides extracts differences from defaults', () => {
|
||||
const customLimits = {
|
||||
...DEFAULT_FREE_LIMITS,
|
||||
max_guilds: 150,
|
||||
max_message_length: 3000,
|
||||
};
|
||||
|
||||
const overrides = computeOverrides(customLimits, DEFAULT_FREE_LIMITS);
|
||||
|
||||
expect(overrides).toEqual({
|
||||
max_guilds: 150,
|
||||
max_message_length: 3000,
|
||||
});
|
||||
});
|
||||
|
||||
test('computeWireFormat creates wire format with overrides', () => {
|
||||
const config: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {...DEFAULT_FREE_LIMITS},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {...DEFAULT_PREMIUM_LIMITS},
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
const wireFormat = computeWireFormat(config);
|
||||
|
||||
expect(wireFormat.version).toBe(2);
|
||||
expect(wireFormat.traitDefinitions).toEqual(['premium']);
|
||||
expect(wireFormat.rules).toHaveLength(2);
|
||||
expect(wireFormat.defaultsHash).toBeTruthy();
|
||||
|
||||
expect(wireFormat.rules[0].id).toBe('default');
|
||||
expect(wireFormat.rules[0].overrides).toEqual({});
|
||||
|
||||
expect(wireFormat.rules[1].id).toBe('premium');
|
||||
expect(Object.keys(wireFormat.rules[1].overrides).length).toBeGreaterThan(0);
|
||||
expect(wireFormat.rules[1].overrides.max_guilds).toBe(200);
|
||||
});
|
||||
|
||||
test('expandWireFormat reconstructs full config from overrides', () => {
|
||||
const config: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {...DEFAULT_FREE_LIMITS},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {...DEFAULT_PREMIUM_LIMITS},
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
const wireFormat = computeWireFormat(config);
|
||||
const expanded = expandWireFormat(wireFormat);
|
||||
|
||||
expect(expanded.version).toBe(2);
|
||||
expect(expanded.traitDefinitions).toEqual(['premium']);
|
||||
expect(expanded.rules).toHaveLength(2);
|
||||
|
||||
expect(expanded.rules[0].limits.max_guilds).toBe(100);
|
||||
expect(expanded.rules[1].limits.max_guilds).toBe(200);
|
||||
expect(expanded.rules[1].limits.max_message_length).toBe(4000);
|
||||
});
|
||||
|
||||
test('roundtrip: expand(compute(config)) equals config', () => {
|
||||
const config: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {...DEFAULT_FREE_LIMITS},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {
|
||||
...DEFAULT_PREMIUM_LIMITS,
|
||||
max_guilds: 250,
|
||||
},
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
const wireFormat = computeWireFormat(config);
|
||||
const expanded = expandWireFormat(wireFormat);
|
||||
|
||||
expect(expanded.rules[0].limits).toEqual(config.rules[0].limits);
|
||||
expect(expanded.rules[1].limits.max_guilds).toBe(250);
|
||||
expect(expanded.rules[1].limits.max_message_length).toBe(4000);
|
||||
});
|
||||
});
|
||||
178
fluxer/packages/limits/src/__tests__/LimitResolver.test.tsx
Normal file
178
fluxer/packages/limits/src/__tests__/LimitResolver.test.tsx
Normal file
@@ -0,0 +1,178 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import {DEFAULT_FREE_LIMITS, DEFAULT_PREMIUM_LIMITS} from '@fluxer/limits/src/LimitDefaults';
|
||||
import {resolveLimit, resolveLimits} from '@fluxer/limits/src/LimitResolver';
|
||||
import type {LimitConfigSnapshot, LimitMatchContext} from '@fluxer/limits/src/LimitTypes';
|
||||
import {describe, expect, test} from 'vitest';
|
||||
|
||||
describe('LimitResolver', () => {
|
||||
test('resolveLimits returns default free limits for empty snapshot', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: [],
|
||||
rules: [],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(),
|
||||
guildFeatures: new Set(),
|
||||
};
|
||||
|
||||
const result = resolveLimits(snapshot, ctx);
|
||||
|
||||
expect(result.limits).toEqual(DEFAULT_FREE_LIMITS);
|
||||
});
|
||||
|
||||
test('resolveLimits applies premium limits for premium trait', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {...DEFAULT_FREE_LIMITS},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {...DEFAULT_PREMIUM_LIMITS},
|
||||
},
|
||||
],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(['premium']),
|
||||
guildFeatures: new Set(),
|
||||
};
|
||||
|
||||
const result = resolveLimits(snapshot, ctx);
|
||||
|
||||
expect(result.limits.max_guilds).toBe(200);
|
||||
expect(result.limits.max_message_length).toBe(4000);
|
||||
expect(result.limits.feature_animated_avatar).toBe(1);
|
||||
});
|
||||
|
||||
test('resolveLimits merges with Math.max', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium', 'special'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {max_guilds: 100},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {max_guilds: 200},
|
||||
},
|
||||
{
|
||||
id: 'special',
|
||||
filters: {traits: ['special']},
|
||||
limits: {max_guilds: 150},
|
||||
},
|
||||
],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(['premium', 'special']),
|
||||
guildFeatures: new Set(),
|
||||
};
|
||||
|
||||
const result = resolveLimits(snapshot, ctx);
|
||||
|
||||
expect(result.limits.max_guilds).toBe(200);
|
||||
});
|
||||
|
||||
test('resolveLimits applies rules by specificity order', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'combined',
|
||||
filters: {traits: ['premium'], guildFeatures: ['MORE_EMOJI']},
|
||||
limits: {max_guild_emojis_static: 500},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {max_guild_emojis_static: 100},
|
||||
},
|
||||
{
|
||||
id: 'default',
|
||||
limits: {max_guild_emojis_static: 50},
|
||||
},
|
||||
],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(['premium']),
|
||||
guildFeatures: new Set(['MORE_EMOJI']),
|
||||
};
|
||||
|
||||
const result = resolveLimits(snapshot, ctx, {evaluationContext: 'guild'});
|
||||
|
||||
expect(result.limits.max_guild_emojis_static).toBe(500);
|
||||
});
|
||||
|
||||
test('resolveLimit returns specific limit value', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium'],
|
||||
rules: [
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {max_guilds: 200},
|
||||
},
|
||||
],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(['premium']),
|
||||
guildFeatures: new Set(),
|
||||
};
|
||||
|
||||
const result = resolveLimit(snapshot, ctx, 'max_guilds');
|
||||
|
||||
expect(result).toBe(200);
|
||||
});
|
||||
|
||||
test('resolveLimits ignores non-matching rules', () => {
|
||||
const snapshot: LimitConfigSnapshot = {
|
||||
traitDefinitions: ['premium', 'special'],
|
||||
rules: [
|
||||
{
|
||||
id: 'default',
|
||||
limits: {max_guilds: 100},
|
||||
},
|
||||
{
|
||||
id: 'premium',
|
||||
filters: {traits: ['premium']},
|
||||
limits: {max_guilds: 200},
|
||||
},
|
||||
{
|
||||
id: 'special',
|
||||
filters: {traits: ['special']},
|
||||
limits: {max_guilds: 300},
|
||||
},
|
||||
],
|
||||
};
|
||||
const ctx: LimitMatchContext = {
|
||||
traits: new Set(['premium']),
|
||||
guildFeatures: new Set(),
|
||||
};
|
||||
|
||||
const result = resolveLimits(snapshot, ctx);
|
||||
|
||||
expect(result.limits.max_guilds).toBe(200);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,66 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import {calculateSpecificity, compareSpecificity} from '@fluxer/limits/src/LimitSpecificity';
|
||||
import {describe, expect, test} from 'vitest';
|
||||
|
||||
describe('LimitSpecificity', () => {
|
||||
test('calculateSpecificity returns 0 for undefined filters', () => {
|
||||
expect(calculateSpecificity(undefined)).toBe(0);
|
||||
});
|
||||
|
||||
test('calculateSpecificity returns 0 for empty filters', () => {
|
||||
expect(calculateSpecificity({})).toBe(0);
|
||||
});
|
||||
|
||||
test('calculateSpecificity counts traits', () => {
|
||||
expect(calculateSpecificity({traits: ['premium']})).toBe(1);
|
||||
expect(calculateSpecificity({traits: ['premium', 'verified']})).toBe(2);
|
||||
});
|
||||
|
||||
test('calculateSpecificity counts guild features', () => {
|
||||
expect(calculateSpecificity({guildFeatures: ['MORE_EMOJI']})).toBe(1);
|
||||
expect(calculateSpecificity({guildFeatures: ['MORE_EMOJI', 'MORE_STICKERS']})).toBe(2);
|
||||
});
|
||||
|
||||
test('calculateSpecificity counts combined traits and guild features', () => {
|
||||
expect(calculateSpecificity({traits: ['premium'], guildFeatures: ['MORE_EMOJI']})).toBe(2);
|
||||
expect(
|
||||
calculateSpecificity({
|
||||
traits: ['premium', 'verified'],
|
||||
guildFeatures: ['MORE_EMOJI', 'MORE_STICKERS'],
|
||||
}),
|
||||
).toBe(4);
|
||||
});
|
||||
|
||||
test('compareSpecificity returns negative when a is less specific', () => {
|
||||
expect(compareSpecificity(undefined, {traits: ['premium']})).toBeLessThan(0);
|
||||
expect(compareSpecificity({traits: ['premium']}, {traits: ['premium', 'verified']})).toBeLessThan(0);
|
||||
});
|
||||
|
||||
test('compareSpecificity returns 0 when equal specificity', () => {
|
||||
expect(compareSpecificity(undefined, undefined)).toBe(0);
|
||||
expect(compareSpecificity({traits: ['premium']}, {traits: ['verified']})).toBe(0);
|
||||
});
|
||||
|
||||
test('compareSpecificity returns positive when a is more specific', () => {
|
||||
expect(compareSpecificity({traits: ['premium']}, undefined)).toBeGreaterThan(0);
|
||||
expect(compareSpecificity({traits: ['premium', 'verified']}, {traits: ['premium']})).toBeGreaterThan(0);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user