feat(web): add bilingual website and central account frontend
This commit is contained in:
commit
622f396364
20 changed files with 1315 additions and 0 deletions
6
.gitignore
vendored
Normal file
6
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
/dist/
|
||||||
|
/node_modules/
|
||||||
|
.env
|
||||||
|
.env.*
|
||||||
|
*.log
|
||||||
|
.DS_Store
|
||||||
674
LICENSE
Normal file
674
LICENSE
Normal file
|
|
@ -0,0 +1,674 @@
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 3, 29 June 2007
|
||||||
|
|
||||||
|
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The GNU General Public License is a free, copyleft license for
|
||||||
|
software and other kinds of works.
|
||||||
|
|
||||||
|
The licenses for most software and other practical works are designed
|
||||||
|
to take away your freedom to share and change the works. By contrast,
|
||||||
|
the GNU General Public License is intended to guarantee your freedom to
|
||||||
|
share and change all versions of a program--to make sure it remains free
|
||||||
|
software for all its users. We, the Free Software Foundation, use the
|
||||||
|
GNU General Public License for most of our software; it applies also to
|
||||||
|
any other work released this way by its authors. You can apply it to
|
||||||
|
your programs, too.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom, not
|
||||||
|
price. Our General Public Licenses are designed to make sure that you
|
||||||
|
have the freedom to distribute copies of free software (and charge for
|
||||||
|
them if you wish), that you receive source code or can get it if you
|
||||||
|
want it, that you can change the software or use pieces of it in new
|
||||||
|
free programs, and that you know you can do these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to prevent others from denying you
|
||||||
|
these rights or asking you to surrender the rights. Therefore, you have
|
||||||
|
certain responsibilities if you distribute copies of the software, or if
|
||||||
|
you modify it: responsibilities to respect the freedom of others.
|
||||||
|
|
||||||
|
For example, if you distribute copies of such a program, whether
|
||||||
|
gratis or for a fee, you must pass on to the recipients the same
|
||||||
|
freedoms that you received. You must make sure that they, too, receive
|
||||||
|
or can get the source code. And you must show them these terms so they
|
||||||
|
know their rights.
|
||||||
|
|
||||||
|
Developers that use the GNU GPL protect your rights with two steps:
|
||||||
|
(1) assert copyright on the software, and (2) offer you this License
|
||||||
|
giving you legal permission to copy, distribute and/or modify it.
|
||||||
|
|
||||||
|
For the developers' and authors' protection, the GPL clearly explains
|
||||||
|
that there is no warranty for this free software. For both users' and
|
||||||
|
authors' sake, the GPL requires that modified versions be marked as
|
||||||
|
changed, so that their problems will not be attributed erroneously to
|
||||||
|
authors of previous versions.
|
||||||
|
|
||||||
|
Some devices are designed to deny users access to install or run
|
||||||
|
modified versions of the software inside them, although the manufacturer
|
||||||
|
can do so. This is fundamentally incompatible with the aim of
|
||||||
|
protecting users' freedom to change the software. The systematic
|
||||||
|
pattern of such abuse occurs in the area of products for individuals to
|
||||||
|
use, which is precisely where it is most unacceptable. Therefore, we
|
||||||
|
have designed this version of the GPL to prohibit the practice for those
|
||||||
|
products. If such problems arise substantially in other domains, we
|
||||||
|
stand ready to extend this provision to those domains in future versions
|
||||||
|
of the GPL, as needed to protect the freedom of users.
|
||||||
|
|
||||||
|
Finally, every program is threatened constantly by software patents.
|
||||||
|
States should not allow patents to restrict development and use of
|
||||||
|
software on general-purpose computers, but in those that do, we wish to
|
||||||
|
avoid the special danger that patents applied to a free program could
|
||||||
|
make it effectively proprietary. To prevent this, the GPL assures that
|
||||||
|
patents cannot be used to render the program non-free.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
0. Definitions.
|
||||||
|
|
||||||
|
"This License" refers to version 3 of the GNU General Public License.
|
||||||
|
|
||||||
|
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||||
|
works, such as semiconductor masks.
|
||||||
|
|
||||||
|
"The Program" refers to any copyrightable work licensed under this
|
||||||
|
License. Each licensee is addressed as "you". "Licensees" and
|
||||||
|
"recipients" may be individuals or organizations.
|
||||||
|
|
||||||
|
To "modify" a work means to copy from or adapt all or part of the work
|
||||||
|
in a fashion requiring copyright permission, other than the making of an
|
||||||
|
exact copy. The resulting work is called a "modified version" of the
|
||||||
|
earlier work or a work "based on" the earlier work.
|
||||||
|
|
||||||
|
A "covered work" means either the unmodified Program or a work based
|
||||||
|
on the Program.
|
||||||
|
|
||||||
|
To "propagate" a work means to do anything with it that, without
|
||||||
|
permission, would make you directly or secondarily liable for
|
||||||
|
infringement under applicable copyright law, except executing it on a
|
||||||
|
computer or modifying a private copy. Propagation includes copying,
|
||||||
|
distribution (with or without modification), making available to the
|
||||||
|
public, and in some countries other activities as well.
|
||||||
|
|
||||||
|
To "convey" a work means any kind of propagation that enables other
|
||||||
|
parties to make or receive copies. Mere interaction with a user through
|
||||||
|
a computer network, with no transfer of a copy, is not conveying.
|
||||||
|
|
||||||
|
An interactive user interface displays "Appropriate Legal Notices"
|
||||||
|
to the extent that it includes a convenient and prominently visible
|
||||||
|
feature that (1) displays an appropriate copyright notice, and (2)
|
||||||
|
tells the user that there is no warranty for the work (except to the
|
||||||
|
extent that warranties are provided), that licensees may convey the
|
||||||
|
work under this License, and how to view a copy of this License. If
|
||||||
|
the interface presents a list of user commands or options, such as a
|
||||||
|
menu, a prominent item in the list meets this criterion.
|
||||||
|
|
||||||
|
1. Source Code.
|
||||||
|
|
||||||
|
The "source code" for a work means the preferred form of the work
|
||||||
|
for making modifications to it. "Object code" means any non-source
|
||||||
|
form of a work.
|
||||||
|
|
||||||
|
A "Standard Interface" means an interface that either is an official
|
||||||
|
standard defined by a recognized standards body, or, in the case of
|
||||||
|
interfaces specified for a particular programming language, one that
|
||||||
|
is widely used among developers working in that language.
|
||||||
|
|
||||||
|
The "System Libraries" of an executable work include anything, other
|
||||||
|
than the work as a whole, that (a) is included in the normal form of
|
||||||
|
packaging a Major Component, but which is not part of that Major
|
||||||
|
Component, and (b) serves only to enable use of the work with that
|
||||||
|
Major Component, or to implement a Standard Interface for which an
|
||||||
|
implementation is available to the public in source code form. A
|
||||||
|
"Major Component", in this context, means a major essential component
|
||||||
|
(kernel, window system, and so on) of the specific operating system
|
||||||
|
(if any) on which the executable work runs, or a compiler used to
|
||||||
|
produce the work, or an object code interpreter used to run it.
|
||||||
|
|
||||||
|
The "Corresponding Source" for a work in object code form means all
|
||||||
|
the source code needed to generate, install, and (for an executable
|
||||||
|
work) run the object code and to modify the work, including scripts to
|
||||||
|
control those activities. However, it does not include the work's
|
||||||
|
System Libraries, or general-purpose tools or generally available free
|
||||||
|
programs which are used unmodified in performing those activities but
|
||||||
|
which are not part of the work. For example, Corresponding Source
|
||||||
|
includes interface definition files associated with source files for
|
||||||
|
the work, and the source code for shared libraries and dynamically
|
||||||
|
linked subprograms that the work is specifically designed to require,
|
||||||
|
such as by intimate data communication or control flow between those
|
||||||
|
subprograms and other parts of the work.
|
||||||
|
|
||||||
|
The Corresponding Source need not include anything that users
|
||||||
|
can regenerate automatically from other parts of the Corresponding
|
||||||
|
Source.
|
||||||
|
|
||||||
|
The Corresponding Source for a work in source code form is that
|
||||||
|
same work.
|
||||||
|
|
||||||
|
2. Basic Permissions.
|
||||||
|
|
||||||
|
All rights granted under this License are granted for the term of
|
||||||
|
copyright on the Program, and are irrevocable provided the stated
|
||||||
|
conditions are met. This License explicitly affirms your unlimited
|
||||||
|
permission to run the unmodified Program. The output from running a
|
||||||
|
covered work is covered by this License only if the output, given its
|
||||||
|
content, constitutes a covered work. This License acknowledges your
|
||||||
|
rights of fair use or other equivalent, as provided by copyright law.
|
||||||
|
|
||||||
|
You may make, run and propagate covered works that you do not
|
||||||
|
convey, without conditions so long as your license otherwise remains
|
||||||
|
in force. You may convey covered works to others for the sole purpose
|
||||||
|
of having them make modifications exclusively for you, or provide you
|
||||||
|
with facilities for running those works, provided that you comply with
|
||||||
|
the terms of this License in conveying all material for which you do
|
||||||
|
not control copyright. Those thus making or running the covered works
|
||||||
|
for you must do so exclusively on your behalf, under your direction
|
||||||
|
and control, on terms that prohibit them from making any copies of
|
||||||
|
your copyrighted material outside their relationship with you.
|
||||||
|
|
||||||
|
Conveying under any other circumstances is permitted solely under
|
||||||
|
the conditions stated below. Sublicensing is not allowed; section 10
|
||||||
|
makes it unnecessary.
|
||||||
|
|
||||||
|
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||||
|
|
||||||
|
No covered work shall be deemed part of an effective technological
|
||||||
|
measure under any applicable law fulfilling obligations under article
|
||||||
|
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||||
|
similar laws prohibiting or restricting circumvention of such
|
||||||
|
measures.
|
||||||
|
|
||||||
|
When you convey a covered work, you waive any legal power to forbid
|
||||||
|
circumvention of technological measures to the extent such circumvention
|
||||||
|
is effected by exercising rights under this License with respect to
|
||||||
|
the covered work, and you disclaim any intention to limit operation or
|
||||||
|
modification of the work as a means of enforcing, against the work's
|
||||||
|
users, your or third parties' legal rights to forbid circumvention of
|
||||||
|
technological measures.
|
||||||
|
|
||||||
|
4. Conveying Verbatim Copies.
|
||||||
|
|
||||||
|
You may convey verbatim copies of the Program's source code as you
|
||||||
|
receive it, in any medium, provided that you conspicuously and
|
||||||
|
appropriately publish on each copy an appropriate copyright notice;
|
||||||
|
keep intact all notices stating that this License and any
|
||||||
|
non-permissive terms added in accord with section 7 apply to the code;
|
||||||
|
keep intact all notices of the absence of any warranty; and give all
|
||||||
|
recipients a copy of this License along with the Program.
|
||||||
|
|
||||||
|
You may charge any price or no price for each copy that you convey,
|
||||||
|
and you may offer support or warranty protection for a fee.
|
||||||
|
|
||||||
|
5. Conveying Modified Source Versions.
|
||||||
|
|
||||||
|
You may convey a work based on the Program, or the modifications to
|
||||||
|
produce it from the Program, in the form of source code under the
|
||||||
|
terms of section 4, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) The work must carry prominent notices stating that you modified
|
||||||
|
it, and giving a relevant date.
|
||||||
|
|
||||||
|
b) The work must carry prominent notices stating that it is
|
||||||
|
released under this License and any conditions added under section
|
||||||
|
7. This requirement modifies the requirement in section 4 to
|
||||||
|
"keep intact all notices".
|
||||||
|
|
||||||
|
c) You must license the entire work, as a whole, under this
|
||||||
|
License to anyone who comes into possession of a copy. This
|
||||||
|
License will therefore apply, along with any applicable section 7
|
||||||
|
additional terms, to the whole of the work, and all its parts,
|
||||||
|
regardless of how they are packaged. This License gives no
|
||||||
|
permission to license the work in any other way, but it does not
|
||||||
|
invalidate such permission if you have separately received it.
|
||||||
|
|
||||||
|
d) If the work has interactive user interfaces, each must display
|
||||||
|
Appropriate Legal Notices; however, if the Program has interactive
|
||||||
|
interfaces that do not display Appropriate Legal Notices, your
|
||||||
|
work need not make them do so.
|
||||||
|
|
||||||
|
A compilation of a covered work with other separate and independent
|
||||||
|
works, which are not by their nature extensions of the covered work,
|
||||||
|
and which are not combined with it such as to form a larger program,
|
||||||
|
in or on a volume of a storage or distribution medium, is called an
|
||||||
|
"aggregate" if the compilation and its resulting copyright are not
|
||||||
|
used to limit the access or legal rights of the compilation's users
|
||||||
|
beyond what the individual works permit. Inclusion of a covered work
|
||||||
|
in an aggregate does not cause this License to apply to the other
|
||||||
|
parts of the aggregate.
|
||||||
|
|
||||||
|
6. Conveying Non-Source Forms.
|
||||||
|
|
||||||
|
You may convey a covered work in object code form under the terms
|
||||||
|
of sections 4 and 5, provided that you also convey the
|
||||||
|
machine-readable Corresponding Source under the terms of this License,
|
||||||
|
in one of these ways:
|
||||||
|
|
||||||
|
a) Convey the object code in, or embodied in, a physical product
|
||||||
|
(including a physical distribution medium), accompanied by the
|
||||||
|
Corresponding Source fixed on a durable physical medium
|
||||||
|
customarily used for software interchange.
|
||||||
|
|
||||||
|
b) Convey the object code in, or embodied in, a physical product
|
||||||
|
(including a physical distribution medium), accompanied by a
|
||||||
|
written offer, valid for at least three years and valid for as
|
||||||
|
long as you offer spare parts or customer support for that product
|
||||||
|
model, to give anyone who possesses the object code either (1) a
|
||||||
|
copy of the Corresponding Source for all the software in the
|
||||||
|
product that is covered by this License, on a durable physical
|
||||||
|
medium customarily used for software interchange, for a price no
|
||||||
|
more than your reasonable cost of physically performing this
|
||||||
|
conveying of source, or (2) access to copy the
|
||||||
|
Corresponding Source from a network server at no charge.
|
||||||
|
|
||||||
|
c) Convey individual copies of the object code with a copy of the
|
||||||
|
written offer to provide the Corresponding Source. This
|
||||||
|
alternative is allowed only occasionally and noncommercially, and
|
||||||
|
only if you received the object code with such an offer, in accord
|
||||||
|
with subsection 6b.
|
||||||
|
|
||||||
|
d) Convey the object code by offering access from a designated
|
||||||
|
place (gratis or for a charge), and offer equivalent access to the
|
||||||
|
Corresponding Source in the same way through the same place at no
|
||||||
|
further charge. You need not require recipients to copy the
|
||||||
|
Corresponding Source along with the object code. If the place to
|
||||||
|
copy the object code is a network server, the Corresponding Source
|
||||||
|
may be on a different server (operated by you or a third party)
|
||||||
|
that supports equivalent copying facilities, provided you maintain
|
||||||
|
clear directions next to the object code saying where to find the
|
||||||
|
Corresponding Source. Regardless of what server hosts the
|
||||||
|
Corresponding Source, you remain obligated to ensure that it is
|
||||||
|
available for as long as needed to satisfy these requirements.
|
||||||
|
|
||||||
|
e) Convey the object code using peer-to-peer transmission, provided
|
||||||
|
you inform other peers where the object code and Corresponding
|
||||||
|
Source of the work are being offered to the general public at no
|
||||||
|
charge under subsection 6d.
|
||||||
|
|
||||||
|
A separable portion of the object code, whose source code is excluded
|
||||||
|
from the Corresponding Source as a System Library, need not be
|
||||||
|
included in conveying the object code work.
|
||||||
|
|
||||||
|
A "User Product" is either (1) a "consumer product", which means any
|
||||||
|
tangible personal property which is normally used for personal, family,
|
||||||
|
or household purposes, or (2) anything designed or sold for incorporation
|
||||||
|
into a dwelling. In determining whether a product is a consumer product,
|
||||||
|
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||||
|
product received by a particular user, "normally used" refers to a
|
||||||
|
typical or common use of that class of product, regardless of the status
|
||||||
|
of the particular user or of the way in which the particular user
|
||||||
|
actually uses, or expects or is expected to use, the product. A product
|
||||||
|
is a consumer product regardless of whether the product has substantial
|
||||||
|
commercial, industrial or non-consumer uses, unless such uses represent
|
||||||
|
the only significant mode of use of the product.
|
||||||
|
|
||||||
|
"Installation Information" for a User Product means any methods,
|
||||||
|
procedures, authorization keys, or other information required to install
|
||||||
|
and execute modified versions of a covered work in that User Product from
|
||||||
|
a modified version of its Corresponding Source. The information must
|
||||||
|
suffice to ensure that the continued functioning of the modified object
|
||||||
|
code is in no case prevented or interfered with solely because
|
||||||
|
modification has been made.
|
||||||
|
|
||||||
|
If you convey an object code work under this section in, or with, or
|
||||||
|
specifically for use in, a User Product, and the conveying occurs as
|
||||||
|
part of a transaction in which the right of possession and use of the
|
||||||
|
User Product is transferred to the recipient in perpetuity or for a
|
||||||
|
fixed term (regardless of how the transaction is characterized), the
|
||||||
|
Corresponding Source conveyed under this section must be accompanied
|
||||||
|
by the Installation Information. But this requirement does not apply
|
||||||
|
if neither you nor any third party retains the ability to install
|
||||||
|
modified object code on the User Product (for example, the work has
|
||||||
|
been installed in ROM).
|
||||||
|
|
||||||
|
The requirement to provide Installation Information does not include a
|
||||||
|
requirement to continue to provide support service, warranty, or updates
|
||||||
|
for a work that has been modified or installed by the recipient, or for
|
||||||
|
the User Product in which it has been modified or installed. Access to a
|
||||||
|
network may be denied when the modification itself materially and
|
||||||
|
adversely affects the operation of the network or violates the rules and
|
||||||
|
protocols for communication across the network.
|
||||||
|
|
||||||
|
Corresponding Source conveyed, and Installation Information provided,
|
||||||
|
in accord with this section must be in a format that is publicly
|
||||||
|
documented (and with an implementation available to the public in
|
||||||
|
source code form), and must require no special password or key for
|
||||||
|
unpacking, reading or copying.
|
||||||
|
|
||||||
|
7. Additional Terms.
|
||||||
|
|
||||||
|
"Additional permissions" are terms that supplement the terms of this
|
||||||
|
License by making exceptions from one or more of its conditions.
|
||||||
|
Additional permissions that are applicable to the entire Program shall
|
||||||
|
be treated as though they were included in this License, to the extent
|
||||||
|
that they are valid under applicable law. If additional permissions
|
||||||
|
apply only to part of the Program, that part may be used separately
|
||||||
|
under those permissions, but the entire Program remains governed by
|
||||||
|
this License without regard to the additional permissions.
|
||||||
|
|
||||||
|
When you convey a copy of a covered work, you may at your option
|
||||||
|
remove any additional permissions from that copy, or from any part of
|
||||||
|
it. (Additional permissions may be written to require their own
|
||||||
|
removal in certain cases when you modify the work.) You may place
|
||||||
|
additional permissions on material, added by you to a covered work,
|
||||||
|
for which you have or can give appropriate copyright permission.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, for material you
|
||||||
|
add to a covered work, you may (if authorized by the copyright holders of
|
||||||
|
that material) supplement the terms of this License with terms:
|
||||||
|
|
||||||
|
a) Disclaiming warranty or limiting liability differently from the
|
||||||
|
terms of sections 15 and 16 of this License; or
|
||||||
|
|
||||||
|
b) Requiring preservation of specified reasonable legal notices or
|
||||||
|
author attributions in that material or in the Appropriate Legal
|
||||||
|
Notices displayed by works containing it; or
|
||||||
|
|
||||||
|
c) Prohibiting misrepresentation of the origin of that material, or
|
||||||
|
requiring that modified versions of such material be marked in
|
||||||
|
reasonable ways as different from the original version; or
|
||||||
|
|
||||||
|
d) Limiting the use for publicity purposes of names of licensors or
|
||||||
|
authors of the material; or
|
||||||
|
|
||||||
|
e) Declining to grant rights under trademark law for use of some
|
||||||
|
trade names, trademarks, or service marks; or
|
||||||
|
|
||||||
|
f) Requiring indemnification of licensors and authors of that
|
||||||
|
material by anyone who conveys the material (or modified versions of
|
||||||
|
it) with contractual assumptions of liability to the recipient, for
|
||||||
|
any liability that these contractual assumptions directly impose on
|
||||||
|
those licensors and authors.
|
||||||
|
|
||||||
|
All other non-permissive additional terms are considered "further
|
||||||
|
restrictions" within the meaning of section 10. If the Program as you
|
||||||
|
received it, or any part of it, contains a notice stating that it is
|
||||||
|
governed by this License along with a term that is a further
|
||||||
|
restriction, you may remove that term. If a license document contains
|
||||||
|
a further restriction but permits relicensing or conveying under this
|
||||||
|
License, you may add to a covered work material governed by the terms
|
||||||
|
of that license document, provided that the further restriction does
|
||||||
|
not survive such relicensing or conveying.
|
||||||
|
|
||||||
|
If you add terms to a covered work in accord with this section, you
|
||||||
|
must place, in the relevant source files, a statement of the
|
||||||
|
additional terms that apply to those files, or a notice indicating
|
||||||
|
where to find the applicable terms.
|
||||||
|
|
||||||
|
Additional terms, permissive or non-permissive, may be stated in the
|
||||||
|
form of a separately written license, or stated as exceptions;
|
||||||
|
the above requirements apply either way.
|
||||||
|
|
||||||
|
8. Termination.
|
||||||
|
|
||||||
|
You may not propagate or modify a covered work except as expressly
|
||||||
|
provided under this License. Any attempt otherwise to propagate or
|
||||||
|
modify it is void, and will automatically terminate your rights under
|
||||||
|
this License (including any patent licenses granted under the third
|
||||||
|
paragraph of section 11).
|
||||||
|
|
||||||
|
However, if you cease all violation of this License, then your
|
||||||
|
license from a particular copyright holder is reinstated (a)
|
||||||
|
provisionally, unless and until the copyright holder explicitly and
|
||||||
|
finally terminates your license, and (b) permanently, if the copyright
|
||||||
|
holder fails to notify you of the violation by some reasonable means
|
||||||
|
prior to 60 days after the cessation.
|
||||||
|
|
||||||
|
Moreover, your license from a particular copyright holder is
|
||||||
|
reinstated permanently if the copyright holder notifies you of the
|
||||||
|
violation by some reasonable means, this is the first time you have
|
||||||
|
received notice of violation of this License (for any work) from that
|
||||||
|
copyright holder, and you cure the violation prior to 30 days after
|
||||||
|
your receipt of the notice.
|
||||||
|
|
||||||
|
Termination of your rights under this section does not terminate the
|
||||||
|
licenses of parties who have received copies or rights from you under
|
||||||
|
this License. If your rights have been terminated and not permanently
|
||||||
|
reinstated, you do not qualify to receive new licenses for the same
|
||||||
|
material under section 10.
|
||||||
|
|
||||||
|
9. Acceptance Not Required for Having Copies.
|
||||||
|
|
||||||
|
You are not required to accept this License in order to receive or
|
||||||
|
run a copy of the Program. Ancillary propagation of a covered work
|
||||||
|
occurring solely as a consequence of using peer-to-peer transmission
|
||||||
|
to receive a copy likewise does not require acceptance. However,
|
||||||
|
nothing other than this License grants you permission to propagate or
|
||||||
|
modify any covered work. These actions infringe copyright if you do
|
||||||
|
not accept this License. Therefore, by modifying or propagating a
|
||||||
|
covered work, you indicate your acceptance of this License to do so.
|
||||||
|
|
||||||
|
10. Automatic Licensing of Downstream Recipients.
|
||||||
|
|
||||||
|
Each time you convey a covered work, the recipient automatically
|
||||||
|
receives a license from the original licensors, to run, modify and
|
||||||
|
propagate that work, subject to this License. You are not responsible
|
||||||
|
for enforcing compliance by third parties with this License.
|
||||||
|
|
||||||
|
An "entity transaction" is a transaction transferring control of an
|
||||||
|
organization, or substantially all assets of one, or subdividing an
|
||||||
|
organization, or merging organizations. If propagation of a covered
|
||||||
|
work results from an entity transaction, each party to that
|
||||||
|
transaction who receives a copy of the work also receives whatever
|
||||||
|
licenses to the work the party's predecessor in interest had or could
|
||||||
|
give under the previous paragraph, plus a right to possession of the
|
||||||
|
Corresponding Source of the work from the predecessor in interest, if
|
||||||
|
the predecessor has it or can get it with reasonable efforts.
|
||||||
|
|
||||||
|
You may not impose any further restrictions on the exercise of the
|
||||||
|
rights granted or affirmed under this License. For example, you may
|
||||||
|
not impose a license fee, royalty, or other charge for exercise of
|
||||||
|
rights granted under this License, and you may not initiate litigation
|
||||||
|
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||||
|
any patent claim is infringed by making, using, selling, offering for
|
||||||
|
sale, or importing the Program or any portion of it.
|
||||||
|
|
||||||
|
11. Patents.
|
||||||
|
|
||||||
|
A "contributor" is a copyright holder who authorizes use under this
|
||||||
|
License of the Program or a work on which the Program is based. The
|
||||||
|
work thus licensed is called the contributor's "contributor version".
|
||||||
|
|
||||||
|
A contributor's "essential patent claims" are all patent claims
|
||||||
|
owned or controlled by the contributor, whether already acquired or
|
||||||
|
hereafter acquired, that would be infringed by some manner, permitted
|
||||||
|
by this License, of making, using, or selling its contributor version,
|
||||||
|
but do not include claims that would be infringed only as a
|
||||||
|
consequence of further modification of the contributor version. For
|
||||||
|
purposes of this definition, "control" includes the right to grant
|
||||||
|
patent sublicenses in a manner consistent with the requirements of
|
||||||
|
this License.
|
||||||
|
|
||||||
|
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||||
|
patent license under the contributor's essential patent claims, to
|
||||||
|
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||||
|
propagate the contents of its contributor version.
|
||||||
|
|
||||||
|
In the following three paragraphs, a "patent license" is any express
|
||||||
|
agreement or commitment, however denominated, not to enforce a patent
|
||||||
|
(such as an express permission to practice a patent or covenant not to
|
||||||
|
sue for patent infringement). To "grant" such a patent license to a
|
||||||
|
party means to make such an agreement or commitment not to enforce a
|
||||||
|
patent against the party.
|
||||||
|
|
||||||
|
If you convey a covered work, knowingly relying on a patent license,
|
||||||
|
and the Corresponding Source of the work is not available for anyone
|
||||||
|
to copy, free of charge and under the terms of this License, through a
|
||||||
|
publicly available network server or other readily accessible means,
|
||||||
|
then you must either (1) cause the Corresponding Source to be so
|
||||||
|
available, or (2) arrange to deprive yourself of the benefit of the
|
||||||
|
patent license for this particular work, or (3) arrange, in a manner
|
||||||
|
consistent with the requirements of this License, to extend the patent
|
||||||
|
license to downstream recipients. "Knowingly relying" means you have
|
||||||
|
actual knowledge that, but for the patent license, your conveying the
|
||||||
|
covered work in a country, or your recipient's use of the covered work
|
||||||
|
in a country, would infringe one or more identifiable patents in that
|
||||||
|
country that you have reason to believe are valid.
|
||||||
|
|
||||||
|
If, pursuant to or in connection with a single transaction or
|
||||||
|
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||||
|
covered work, and grant a patent license to some of the parties
|
||||||
|
receiving the covered work authorizing them to use, propagate, modify
|
||||||
|
or convey a specific copy of the covered work, then the patent license
|
||||||
|
you grant is automatically extended to all recipients of the covered
|
||||||
|
work and works based on it.
|
||||||
|
|
||||||
|
A patent license is "discriminatory" if it does not include within
|
||||||
|
the scope of its coverage, prohibits the exercise of, or is
|
||||||
|
conditioned on the non-exercise of one or more of the rights that are
|
||||||
|
specifically granted under this License. You may not convey a covered
|
||||||
|
work if you are a party to an arrangement with a third party that is
|
||||||
|
in the business of distributing software, under which you make payment
|
||||||
|
to the third party based on the extent of your activity of conveying
|
||||||
|
the work, and under which the third party grants, to any of the
|
||||||
|
parties who would receive the covered work from you, a discriminatory
|
||||||
|
patent license (a) in connection with copies of the covered work
|
||||||
|
conveyed by you (or copies made from those copies), or (b) primarily
|
||||||
|
for and in connection with specific products or compilations that
|
||||||
|
contain the covered work, unless you entered into that arrangement,
|
||||||
|
or that patent license was granted, prior to 28 March 2007.
|
||||||
|
|
||||||
|
Nothing in this License shall be construed as excluding or limiting
|
||||||
|
any implied license or other defenses to infringement that may
|
||||||
|
otherwise be available to you under applicable patent law.
|
||||||
|
|
||||||
|
12. No Surrender of Others' Freedom.
|
||||||
|
|
||||||
|
If conditions are imposed on you (whether by court order, agreement or
|
||||||
|
otherwise) that contradict the conditions of this License, they do not
|
||||||
|
excuse you from the conditions of this License. If you cannot convey a
|
||||||
|
covered work so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you may
|
||||||
|
not convey it at all. For example, if you agree to terms that obligate you
|
||||||
|
to collect a royalty for further conveying from those to whom you convey
|
||||||
|
the Program, the only way you could satisfy both those terms and this
|
||||||
|
License would be to refrain entirely from conveying the Program.
|
||||||
|
|
||||||
|
13. Use with the GNU Affero General Public License.
|
||||||
|
|
||||||
|
Notwithstanding any other provision of this License, you have
|
||||||
|
permission to link or combine any covered work with a work licensed
|
||||||
|
under version 3 of the GNU Affero General Public License into a single
|
||||||
|
combined work, and to convey the resulting work. The terms of this
|
||||||
|
License will continue to apply to the part which is the covered work,
|
||||||
|
but the special requirements of the GNU Affero General Public License,
|
||||||
|
section 13, concerning interaction through a network will apply to the
|
||||||
|
combination as such.
|
||||||
|
|
||||||
|
14. Revised Versions of this License.
|
||||||
|
|
||||||
|
The Free Software Foundation may publish revised and/or new versions of
|
||||||
|
the GNU General Public License from time to time. Such new versions will
|
||||||
|
be similar in spirit to the present version, but may differ in detail to
|
||||||
|
address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the
|
||||||
|
Program specifies that a certain numbered version of the GNU General
|
||||||
|
Public License "or any later version" applies to it, you have the
|
||||||
|
option of following the terms and conditions either of that numbered
|
||||||
|
version or of any later version published by the Free Software
|
||||||
|
Foundation. If the Program does not specify a version number of the
|
||||||
|
GNU General Public License, you may choose any version ever published
|
||||||
|
by the Free Software Foundation.
|
||||||
|
|
||||||
|
If the Program specifies that a proxy can decide which future
|
||||||
|
versions of the GNU General Public License can be used, that proxy's
|
||||||
|
public statement of acceptance of a version permanently authorizes you
|
||||||
|
to choose that version for the Program.
|
||||||
|
|
||||||
|
Later license versions may give you additional or different
|
||||||
|
permissions. However, no additional obligations are imposed on any
|
||||||
|
author or copyright holder as a result of your choosing to follow a
|
||||||
|
later version.
|
||||||
|
|
||||||
|
15. Disclaimer of Warranty.
|
||||||
|
|
||||||
|
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||||
|
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||||
|
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||||
|
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||||
|
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||||
|
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
16. Limitation of Liability.
|
||||||
|
|
||||||
|
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||||
|
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||||
|
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||||
|
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||||
|
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||||
|
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||||
|
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||||
|
SUCH DAMAGES.
|
||||||
|
|
||||||
|
17. Interpretation of Sections 15 and 16.
|
||||||
|
|
||||||
|
If the disclaimer of warranty and limitation of liability provided
|
||||||
|
above cannot be given local legal effect according to their terms,
|
||||||
|
reviewing courts shall apply local law that most closely approximates
|
||||||
|
an absolute waiver of all civil liability in connection with the
|
||||||
|
Program, unless a warranty or assumption of liability accompanies a
|
||||||
|
copy of the Program in return for a fee.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
How to Apply These Terms to Your New Programs
|
||||||
|
|
||||||
|
If you develop a new program, and you want it to be of the greatest
|
||||||
|
possible use to the public, the best way to achieve this is to make it
|
||||||
|
free software which everyone can redistribute and change under these terms.
|
||||||
|
|
||||||
|
To do so, attach the following notices to the program. It is safest
|
||||||
|
to attach them to the start of each source file to most effectively
|
||||||
|
state the exclusion of warranty; and each file should have at least
|
||||||
|
the "copyright" line and a pointer to where the full notice is found.
|
||||||
|
|
||||||
|
<one line to give the program's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) <year> <name of author>
|
||||||
|
|
||||||
|
This program is free software: you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation, either version 3 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
|
|
||||||
|
This program 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 General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU General Public License
|
||||||
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
If the program does terminal interaction, make it output a short
|
||||||
|
notice like this when it starts in an interactive mode:
|
||||||
|
|
||||||
|
<program> Copyright (C) <year> <name of author>
|
||||||
|
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||||
|
This is free software, and you are welcome to redistribute it
|
||||||
|
under certain conditions; type `show c' for details.
|
||||||
|
|
||||||
|
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||||
|
parts of the General Public License. Of course, your program's commands
|
||||||
|
might be different; for a GUI interface, you would use an "about box".
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or school,
|
||||||
|
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||||
|
For more information on this, and how to apply and follow the GNU GPL, see
|
||||||
|
<https://www.gnu.org/licenses/>.
|
||||||
|
|
||||||
|
The GNU General Public License does not permit incorporating your program
|
||||||
|
into proprietary programs. If your program is a subroutine library, you
|
||||||
|
may consider it more useful to permit linking proprietary applications with
|
||||||
|
the library. If this is what you want to do, use the GNU Lesser General
|
||||||
|
Public License instead of this License. But first, please read
|
||||||
|
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||||
70
README.md
Normal file
70
README.md
Normal file
|
|
@ -0,0 +1,70 @@
|
||||||
|
# VNOX — Web
|
||||||
|
|
||||||
|
> Public project website and account frontend for VNOX Central.
|
||||||
|
|
||||||
|
[](LICENSE)
|
||||||
|
[](https://nodejs.org/)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## What is this?
|
||||||
|
|
||||||
|
A lightweight, self-hosted website for VNOX, a Rust voice and text communication platform. This is a separate repository from [VNOX Client](https://git.wihuk.pro/boba/VNOX-Client) and [VNOX Server](https://git.wihuk.pro/boba/VNOX-Server).
|
||||||
|
|
||||||
|
The site uses plain HTML, CSS and JavaScript modules. There are **no runtime or build dependencies**, third-party scripts, analytics or external fonts.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Responsive Russian/English project pages with the approved VNOX mark.
|
||||||
|
- Interactive, clearly labelled layout illustration and a real native-client screenshot.
|
||||||
|
- Account loading, signed-out, signed-in, unavailable and sign-out states.
|
||||||
|
- GitHub sign-in through VNOX Hub, same-origin cookies and CSRF-protected sign-out.
|
||||||
|
- Explicit early-development status; no invented releases, people or download links.
|
||||||
|
|
||||||
|
The website does not implement identity verification itself. The Rust Hub exchanges GitHub credentials and manages sessions. Central accounts are not yet linked to the desktop client's local cryptographic identity.
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
Requires Node.js 22 or newer. No `npm install` is needed.
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm run dev # Local preview at http://127.0.0.1:4176
|
||||||
|
npm test # Node tests: locale parity, API/security and preview routing
|
||||||
|
npm run build # Copy public/ and src/ into dist/, normalize permissions
|
||||||
|
npm run preview # Preview the built dist/ directory
|
||||||
|
```
|
||||||
|
|
||||||
|
Optional browser QA: `python3 tests/browser_qa.py` uses an existing local Playwright installation and Chromium against the running preview. It does not add a project dependency.
|
||||||
|
|
||||||
|
Set `PORT=4180` to change the preview port. The preview intentionally returns HTTP 503 for API requests; it contains no fake backend or development credentials.
|
||||||
|
|
||||||
|
## Structure
|
||||||
|
|
||||||
|
```text
|
||||||
|
public/ HTML entry point and self-hosted assets
|
||||||
|
src/ Application, API helpers, RU/EN catalogs and styling
|
||||||
|
scripts/ Dependency-free build and loopback preview
|
||||||
|
tests/ Node regression tests
|
||||||
|
docs/ Design direction and Nginx integration example
|
||||||
|
```
|
||||||
|
|
||||||
|
## Hub integration
|
||||||
|
|
||||||
|
Serve `dist/` at the same HTTPS origin as VNOX Hub. `/` and `/account` use `index.html`; preserve proxy routes `/v1/`, `/health`, `/ready` and `/version`. See [Nginx example](docs/nginx-static.conf).
|
||||||
|
|
||||||
|
| Endpoint | Frontend behaviour |
|
||||||
|
| --- | --- |
|
||||||
|
| `GET /v1/info` | Enable sign-in only when `capabilities.github_auth` is `enabled` |
|
||||||
|
| `GET /v1/auth/github/start` | Browser navigation to GitHub authorization |
|
||||||
|
| `GET /v1/auth/session` | Load `authenticated`, public `user` and ephemeral `csrf_token` |
|
||||||
|
| `POST /v1/auth/logout` | Send `X-CSRF-Token`; clear the account after success |
|
||||||
|
|
||||||
|
The Hub sets Secure, HttpOnly cookies. Tokens are never stored in browser storage; only the preferred UI language is persisted. Keep OAuth callback query strings out of reverse-proxy access and error logs. Never place secrets or `.env` files in the static release.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Keep RU/EN catalog keys aligned, render profile values as text and retain keyboard navigation and reduced-motion support. Use descriptive Conventional Commits such as `fix(web): preserve account state when changing language`. Run tests and build before submitting a focused PR; include screenshots for visual changes. See [verification notes](docs/verification.md) for browser QA and current limits.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
GNU GPL version 3. See [LICENSE](LICENSE).
|
||||||
25
docs/design.md
Normal file
25
docs/design.md
Normal file
|
|
@ -0,0 +1,25 @@
|
||||||
|
# Website direction
|
||||||
|
|
||||||
|
VNOX is a self-hosted place for people to talk, built around a native desktop client and independently operated community servers. The website introduces that ownership model and provides the central account entry point.
|
||||||
|
|
||||||
|
- Palette: graphite `#19191b`, raised charcoal `#232325`, paper `#efede8`, muted stone `#aaa6a0`, sand `#dac5a6`, quiet sage `#aabcaa` for verified status only.
|
||||||
|
- Type: system humanist sans (`Segoe UI`, `Noto Sans`, sans-serif), large tightly set headings, comfortable 1.55 body leading. All assets stay on the same origin.
|
||||||
|
- Layout: broad left-aligned headline, an interactive communication diagram on the right, then an asymmetrical project explanation, actual native-client screenshot and a simple development roadmap. Account is a focused single workspace with clear loading, unauthenticated, authenticated and failure states.
|
||||||
|
- Distinction: the approved V doubles as a visual connection joining two people; one small voice diagram supplies the expressive moment. No decorative statistics, testimonials, gradient cards or fictitious downloads.
|
||||||
|
|
||||||
|
```
|
||||||
|
Vnox Project / Client / Roadmap RU EN Account
|
||||||
|
|
||||||
|
Own people. Interactive communication diagram
|
||||||
|
Own connection. Text / Voice / Appearance
|
||||||
|
Introduction clearly labelled as an illustration
|
||||||
|
Account + project
|
||||||
|
|
||||||
|
One application. Native settings screenshot
|
||||||
|
Your own server. feature detail and real source links
|
||||||
|
|
||||||
|
What's available / What's next FAQ
|
||||||
|
Central status Footer
|
||||||
|
```
|
||||||
|
|
||||||
|
Review: a giant neutral product screenshot alone would feel like any desktop-app page. The hero instead explains persistent voice while browsing text through an intentionally small, labelled diagram. Real native-client imagery appears where it supports the appearance/settings explanation. Sand is the approved V brand colour, not a secondary decorative accent.
|
||||||
34
docs/nginx-static.conf
Normal file
34
docs/nginx-static.conf
Normal file
|
|
@ -0,0 +1,34 @@
|
||||||
|
# Merge into the existing HTTPS server block; preserve certificates, ACME and auth proxy.
|
||||||
|
# Set this to the immutable website release selected by the deployment symlink.
|
||||||
|
root /opt/vnox-central/web/current;
|
||||||
|
index index.html;
|
||||||
|
|
||||||
|
# Keep the existing /v1/auth/ location ABOVE the generic API location.
|
||||||
|
# OAuth callback code/state must never be written to access/error logs.
|
||||||
|
location ^~ /v1/auth/ {
|
||||||
|
access_log off;
|
||||||
|
error_log /dev/null;
|
||||||
|
proxy_pass http://127.0.0.1:37623;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Forwarded-Proto https;
|
||||||
|
proxy_set_header X-Forwarded-For $remote_addr;
|
||||||
|
}
|
||||||
|
location ^~ /v1/ {
|
||||||
|
proxy_pass http://127.0.0.1:37623;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Forwarded-Proto https;
|
||||||
|
proxy_set_header X-Forwarded-For $remote_addr;
|
||||||
|
}
|
||||||
|
# Preserve the existing exact /health, /ready and /version proxy locations.
|
||||||
|
|
||||||
|
location / {
|
||||||
|
try_files $uri $uri/ /index.html;
|
||||||
|
add_header Cache-Control "no-store" always;
|
||||||
|
add_header X-Content-Type-Options "nosniff" always;
|
||||||
|
add_header Referrer-Policy "no-referrer" always;
|
||||||
|
add_header X-Frame-Options "DENY" always;
|
||||||
|
add_header Content-Security-Policy "default-src 'none'; script-src 'self'; style-src 'self'; img-src 'self' https://avatars.githubusercontent.com; connect-src 'self'; font-src 'self'; base-uri 'none'; form-action 'self'; frame-ancestors 'none'; object-src 'none'" always;
|
||||||
|
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
|
||||||
|
}
|
||||||
|
# No OAuth credentials, session keys, SMTP configuration or .env files belong in this root.
|
||||||
|
# dist/assets includes both vnox-mark.svg and vnox-mark.png, also used by Hub emails.
|
||||||
23
docs/verification.md
Normal file
23
docs/verification.md
Normal file
|
|
@ -0,0 +1,23 @@
|
||||||
|
# Verification
|
||||||
|
|
||||||
|
Verified locally on 24 October 2026:
|
||||||
|
|
||||||
|
- `npm test`: 7 Node tests passed, including exact catalog parity, authentication request options, malformed-session checks, avatar-origin validation and encoded preview-path traversal.
|
||||||
|
- `npm run build`: static build completed; assets normalized to mode 0644, directories 0755.
|
||||||
|
- `node --check src/app.js`: JavaScript syntax check passed.
|
||||||
|
- `python3 tests/browser_qa.py`: passed with the workstation's existing Playwright and `/usr/bin/chromium`; no browser or dependency was installed by this project.
|
||||||
|
|
||||||
|
The optional browser script requires the loopback preview from `npm run dev` or `npm run preview`. It replaces API responses with test fixtures and refuses non-loopback origins. It checks:
|
||||||
|
|
||||||
|
- Keyboard-operated illustration tabs and theme selection.
|
||||||
|
- Runtime RU/EN changes and layouts at 320, 390, 768 and 1440 pixels, including account views.
|
||||||
|
- Enabled, disabled and unavailable GitHub sign-in; retry after session failure.
|
||||||
|
- Profile values rendered as text, rejected unsafe avatar URLs and no script execution from hostile profile fixtures.
|
||||||
|
- CSRF-header/Origin/POST sign-out and expired-session handling.
|
||||||
|
- Browser storage contains only the UI language; no account tokens are persisted.
|
||||||
|
|
||||||
|
Screenshots were visually inspected at `/tmp/vnox-web-qa/desktop-hero.png`, `mobile-full.png`, `account-login-mobile.png` and `account-profile-desktop.png`. Screenshot profile data is explicitly a browser fixture, absent from production assets.
|
||||||
|
|
||||||
|
## Limits
|
||||||
|
|
||||||
|
These frontend tests do not authorize a real GitHub user, verify provider consent or exercise Hub database/session internals. A live end-to-end GitHub authorization requires the account owner to complete provider consent. The loopback preview intentionally has no backend. Production deployment and HTTPS/security-header checks belong to the site's operator and must preserve the Hub's OAuth callback and cookie configuration.
|
||||||
15
package.json
Normal file
15
package.json
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
{
|
||||||
|
"name": "vnox-web",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"private": true,
|
||||||
|
"type": "module",
|
||||||
|
"license": "GPL-3.0-only",
|
||||||
|
"description": "VNOX public website and central account frontend",
|
||||||
|
"engines": { "node": ">=22" },
|
||||||
|
"scripts": {
|
||||||
|
"dev": "node scripts/serve.mjs",
|
||||||
|
"build": "node scripts/build.mjs",
|
||||||
|
"preview": "node scripts/serve.mjs --dist",
|
||||||
|
"test": "node --test"
|
||||||
|
}
|
||||||
|
}
|
||||||
BIN
public/assets/client-settings.png
Normal file
BIN
public/assets/client-settings.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 59 KiB |
BIN
public/assets/vnox-mark.png
Normal file
BIN
public/assets/vnox-mark.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3 KiB |
1
public/assets/vnox-mark.svg
Normal file
1
public/assets/vnox-mark.svg
Normal file
|
|
@ -0,0 +1 @@
|
||||||
|
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Vnox"><rect width="64" height="64" rx="17" fill="#202022"/><g fill="none" stroke="#dac5a6" stroke-width="5" stroke-linejoin="round" stroke-linecap="round"><path d="M16 20 32 46 48 20"/><path d="M16 20H26M38 20H48"/></g></svg>
|
||||||
|
After Width: | Height: | Size: 308 B |
26
public/index.html
Normal file
26
public/index.html
Normal file
|
|
@ -0,0 +1,26 @@
|
||||||
|
<!doctype html>
|
||||||
|
<html lang="ru">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
|
<meta name="theme-color" content="#19191b">
|
||||||
|
<meta name="description" content="VNOX — голос и чат для своих сообществ. Нативный клиент, собственный сервер и открытый код.">
|
||||||
|
<title>VNOX — Своя связь</title>
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/assets/vnox-mark.svg">
|
||||||
|
<link rel="stylesheet" href="/src/styles.css">
|
||||||
|
<script type="module" src="/src/app.js"></script>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<a class="skip-link" href="#main" data-i18n="skip">Перейти к содержимому</a>
|
||||||
|
<header class="site-header shell">
|
||||||
|
<a class="brand" href="/" aria-label="VNOX"><img src="/assets/vnox-mark.svg" alt="" width="36" height="36"><span>VNOX</span></a>
|
||||||
|
<nav aria-label="Основная навигация" data-i18n-aria="nav">
|
||||||
|
<a href="/#project" data-i18n="navProject">Проект</a><a href="/#client" data-i18n="navClient">Клиент</a><a href="/#roadmap" data-i18n="navRoadmap">Дальше</a>
|
||||||
|
</nav>
|
||||||
|
<div class="header-actions"><div class="language-switch" role="group" aria-label="Язык" data-i18n-aria="language"><button type="button" data-language="ru" aria-pressed="true">RU</button><button type="button" data-language="en" aria-pressed="false">EN</button></div><a class="account-link" href="/account" data-i18n="account">Аккаунт</a></div>
|
||||||
|
</header>
|
||||||
|
<main id="main" tabindex="-1"></main>
|
||||||
|
<footer class="site-footer shell"><a class="brand" href="/"><img src="/assets/vnox-mark.svg" alt="" width="28" height="28"><span>VNOX</span></a><p data-i18n="footer">Сделано для разговоров, которые хочется продолжать.</p><a href="https://www.gnu.org/licenses/gpl-3.0.html" target="_blank" rel="noopener noreferrer">GPLv3</a><a href="https://git.wihuk.pro/boba/VNOX-Server" target="_blank" rel="noopener noreferrer" data-i18n="source">Исходный код</a></footer>
|
||||||
|
<noscript><div class="noscript">Для входа в VNOX Central включите JavaScript. / Enable JavaScript to sign in to VNOX Central.</div></noscript>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
17
scripts/build.mjs
Normal file
17
scripts/build.mjs
Normal file
|
|
@ -0,0 +1,17 @@
|
||||||
|
import { cp, mkdir, rm, chmod, readdir } from 'node:fs/promises';
|
||||||
|
import { fileURLToPath } from 'node:url';
|
||||||
|
const root = fileURLToPath(new URL('../', import.meta.url));
|
||||||
|
await rm(`${root}dist`, { recursive: true, force: true });
|
||||||
|
await mkdir(`${root}dist`, { recursive: true });
|
||||||
|
await cp(`${root}public`, `${root}dist`, { recursive: true });
|
||||||
|
await cp(`${root}src`, `${root}dist/src`, { recursive: true });
|
||||||
|
async function permissions(directory) {
|
||||||
|
await chmod(directory, 0o755);
|
||||||
|
for (const entry of await readdir(directory, { withFileTypes: true })) {
|
||||||
|
const path = `${directory}/${entry.name}`;
|
||||||
|
if (entry.isDirectory()) await permissions(path);
|
||||||
|
else await chmod(path, 0o644);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
await permissions(`${root}dist`);
|
||||||
|
console.log('Built dependency-free static website in dist/');
|
||||||
29
scripts/serve.mjs
Normal file
29
scripts/serve.mjs
Normal file
|
|
@ -0,0 +1,29 @@
|
||||||
|
import { createServer } from 'node:http';
|
||||||
|
import { readFile, stat } from 'node:fs/promises';
|
||||||
|
import { fileURLToPath } from 'node:url';
|
||||||
|
import { extname, resolve, sep } from 'node:path';
|
||||||
|
const root = fileURLToPath(new URL('../', import.meta.url));
|
||||||
|
const production = process.argv.includes('--dist');
|
||||||
|
const port = Number(process.env.PORT ?? 4176);
|
||||||
|
const types = {'.html':'text/html; charset=utf-8','.js':'text/javascript; charset=utf-8','.css':'text/css; charset=utf-8','.svg':'image/svg+xml','.png':'image/png','.json':'application/json'};
|
||||||
|
const server = createServer(async (request,response) => {
|
||||||
|
try {
|
||||||
|
const path = decodeURIComponent(new URL(request.url,'http://localhost').pathname);
|
||||||
|
if (request.method!=='GET' && request.method!=='HEAD') { response.writeHead(405);response.end();return; }
|
||||||
|
if (path.startsWith('/v1/') || ['/health','/ready','/version'].includes(path)) {
|
||||||
|
response.writeHead(503,{'content-type':'application/json','cache-control':'no-store'});
|
||||||
|
response.end(JSON.stringify({error:'preview_has_no_backend'}));return;
|
||||||
|
}
|
||||||
|
const sourcePath = !production && path.startsWith('/src/');
|
||||||
|
const base = production ? resolve(root,'dist') : sourcePath ? resolve(root,'src') : resolve(root,'public');
|
||||||
|
let file = resolve(base, sourcePath ? path.slice('/src/'.length) : `.${path}`);
|
||||||
|
if (path==='/' || path==='/account' || path==='/account/') file=resolve(base,'index.html');
|
||||||
|
if (!file.startsWith(base+sep)) { response.writeHead(403);response.end();return; }
|
||||||
|
const info=await stat(file);
|
||||||
|
if (!info.isFile()) throw new Error('not_file');
|
||||||
|
response.writeHead(200,{'content-type':types[extname(file)]??'application/octet-stream','cache-control':'no-store','x-content-type-options':'nosniff'});
|
||||||
|
response.end(request.method==='HEAD'?undefined:await readFile(file));
|
||||||
|
} catch { response.writeHead(404,{'content-type':'text/plain'});response.end('Not found'); }
|
||||||
|
});
|
||||||
|
server.listen(port,'127.0.0.1',()=>console.log(`VNOX Web: http://127.0.0.1:${port}`));
|
||||||
|
for (const signal of ['SIGINT','SIGTERM']) process.on(signal,()=>server.close(()=>process.exit(0)));
|
||||||
27
src/api.js
Normal file
27
src/api.js
Normal file
|
|
@ -0,0 +1,27 @@
|
||||||
|
export class ApiError extends Error {
|
||||||
|
constructor(status, code) { super(code); this.name = 'ApiError'; this.status = status; }
|
||||||
|
}
|
||||||
|
export async function request(path, { signal, method = 'GET', csrf, fetcher = fetch } = {}) {
|
||||||
|
if (!path.startsWith('/v1/')) throw new TypeError('Only same-origin VNOX API paths are allowed');
|
||||||
|
const response = await fetcher(path, {
|
||||||
|
method, signal, credentials: 'same-origin', cache: 'no-store',
|
||||||
|
headers: { Accept: 'application/json', ...(csrf ? { 'X-CSRF-Token': csrf } : {}) },
|
||||||
|
});
|
||||||
|
if (!response.ok) throw new ApiError(response.status, 'request_failed');
|
||||||
|
if (response.status === 204) return null;
|
||||||
|
return response.json();
|
||||||
|
}
|
||||||
|
export function isSession(value) {
|
||||||
|
return value?.authenticated === false || (value?.authenticated === true
|
||||||
|
&& typeof value.csrf_token === 'string' && value.csrf_token.length > 0
|
||||||
|
&& typeof value.user?.user_id === 'string' && typeof value.user?.handle === 'string'
|
||||||
|
&& typeof value.user?.display_name === 'string');
|
||||||
|
}
|
||||||
|
export function safeAvatar(value) {
|
||||||
|
if (typeof value !== 'string') return null;
|
||||||
|
try {
|
||||||
|
const url = new URL(value);
|
||||||
|
return url.protocol === 'https:' && url.hostname === 'avatars.githubusercontent.com'
|
||||||
|
&& !url.username && !url.password && !url.port ? url.href : null;
|
||||||
|
} catch { return null; }
|
||||||
|
}
|
||||||
165
src/app.js
Normal file
165
src/app.js
Normal file
|
|
@ -0,0 +1,165 @@
|
||||||
|
import { detectLanguage, translate } from './i18n.js';
|
||||||
|
import { request, isSession, safeAvatar } from './api.js';
|
||||||
|
|
||||||
|
let savedLanguage;
|
||||||
|
try { savedLanguage = localStorage.getItem('vnox-web-language'); } catch { /* Storage is optional. */ }
|
||||||
|
let language = detectLanguage(savedLanguage, navigator.languages ?? [navigator.language]);
|
||||||
|
const accountPage = /^\/account\/?$/.test(location.pathname);
|
||||||
|
const main = document.querySelector('main');
|
||||||
|
let activeTab = 'text';
|
||||||
|
let activeTheme = 'dark';
|
||||||
|
let controller;
|
||||||
|
let currentSession;
|
||||||
|
let githubEnabled = false;
|
||||||
|
let sessionState = 'loading';
|
||||||
|
let infoState = 'loading';
|
||||||
|
let logoutState = 'idle';
|
||||||
|
const t = key => translate(language, key);
|
||||||
|
const icon = (name, size = 20) => {
|
||||||
|
const paths = {
|
||||||
|
github: '<path d="M9 19c-4 1-4-2-6-2m12 4v-3.4a3 3 0 0 0-.8-2.3c2.7-.3 5.5-1.3 5.5-6A4.7 4.7 0 0 0 18.4 6a4.4 4.4 0 0 0-.1-3.3s-1-.3-3.4 1.3a11.6 11.6 0 0 0-6.2 0C6.3 2.4 5.3 2.7 5.3 2.7A4.4 4.4 0 0 0 5.2 6 4.7 4.7 0 0 0 4 9.3c0 4.7 2.8 5.7 5.5 6a3 3 0 0 0-.8 2.3V21"/>',
|
||||||
|
voice: '<path d="m11 5-5 4H3v6h3l5 4V5Z"/><path d="M15 8a6 6 0 0 1 0 8m3-11a10 10 0 0 1 0 14"/>',
|
||||||
|
mic: '<rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 10v2a7 7 0 0 0 14 0v-2M12 19v3m-4 0h8"/>',
|
||||||
|
chat: '<path d="M21 11.5a8.4 8.4 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.4 8.4 0 0 1-3.8-.9L3 21l1.9-5.7a8.4 8.4 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.4 8.4 0 0 1 3.8-.9h.5a8.5 8.5 0 0 1 8 8v.5Z"/>',
|
||||||
|
external: '<path d="M15 3h6v6m0-6L10 14"/><path d="M10 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-5"/>',
|
||||||
|
check: '<path d="m5 12 4 4L19 6"/>',
|
||||||
|
copy: '<rect x="8" y="8" width="13" height="13" rx="2"/><path d="M16 8V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h3"/>',
|
||||||
|
back: '<path d="m12 19-7-7 7-7m-7 7h14"/>',
|
||||||
|
};
|
||||||
|
return `<svg width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${paths[name] ?? paths.chat}</svg>`;
|
||||||
|
};
|
||||||
|
const tr = (key, tag = 'span', attrs = '') => `<${tag} data-i18n="${key}" ${attrs}>${t(key)}</${tag}>`;
|
||||||
|
const external = (href, key) => `<a class="text-link" href="${href}" target="_blank" rel="noopener noreferrer">${tr(key)}${icon('external', 15)}</a>`;
|
||||||
|
function landing() {
|
||||||
|
main.innerHTML = `
|
||||||
|
<section class="hero shell" aria-labelledby="hero-title">
|
||||||
|
<div class="hero-copy"><p class="development">${tr('development')}</p>${tr('heroTitle', 'h1', 'id="hero-title"')}${tr('heroText', 'p', 'class="hero-description"')}
|
||||||
|
<div class="hero-actions"><a class="button primary" href="/account">${tr('openCentral')}</a><a class="button quiet" href="#project">${tr('explore')}</a></div>${tr('earlyNote','p','class="small hero-note"')}</div>
|
||||||
|
<div class="diagram-wrap"><div class="diagram-meta">${tr('diagramLabel')}<span class="diagram-dots" aria-hidden="true"><i></i><i></i><i></i></span></div>
|
||||||
|
<div class="product-diagram" data-preview-theme="dark"><div class="diagram-sidebar"><img src="/assets/vnox-mark.svg" alt="" width="32" height="32"><div class="diagram-community">${tr('community')}</div><div class="diagram-channel selected"># ${tr('general')}</div><div class="diagram-channel"># ${tr('ideas')}</div><div class="diagram-voice">${icon('voice',16)}${tr('voiceRoom')}</div><div class="diagram-people"><span class="person-dot"></span>${tr('you')}<span class="person-dot second"></span>${tr('friend')}</div><div class="diagram-self"><span class="mini-avatar">V</span>${tr('you')}${icon('mic',15)}</div></div>
|
||||||
|
<div class="diagram-main"><div class="diagram-header"># ${tr('general')}<span>${icon('chat',17)}</span></div><div id="diagram-content"></div><div class="diagram-call"><span class="connection-dot"></span>${tr('voiceConnected')}${icon('mic',16)}</div></div></div>
|
||||||
|
<div class="diagram-tabs" role="tablist" aria-label="${t('preview')}" data-i18n-aria="preview"><button role="tab" aria-selected="true" aria-controls="diagram-content" id="tab-text" data-tab="text">${tr('textTab')}</button><button role="tab" aria-selected="false" aria-controls="diagram-content" id="tab-voice" data-tab="voice" tabindex="-1">${tr('voiceTab')}</button><button role="tab" aria-selected="false" aria-controls="diagram-content" id="tab-theme" data-tab="theme" tabindex="-1">${tr('themeTab')}</button></div>${tr('diagramNote','p','class="small diagram-note"')}
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
<section class="project-section shell" id="project" aria-labelledby="project-title"><div class="section-intro">${tr('projectTitle','h2','id="project-title"')}${tr('projectText','p')}<div class="source-links">${external('https://git.wihuk.pro/boba/VNOX-Client','clientCode')}${external('https://git.wihuk.pro/boba/VNOX-Server','serverCode')}</div></div><div class="project-points"><article><div class="point-icon">${icon('chat',24)}</div><div>${tr('projectNative','h3')}${tr('projectNativeText','p')}</div></article><article><div class="point-icon">${icon('voice',24)}</div><div>${tr('projectServer','h3')}${tr('projectServerText','p')}</div></article><article><img src="/assets/vnox-mark.svg" alt="" width="40" height="40"><div>${tr('projectCentral','h3')}${tr('projectCentralText','p')}</div></article></div></section>
|
||||||
|
<section class="client-section" id="client" aria-labelledby="client-title"><div class="shell"><div class="client-heading">${tr('clientTitle','h2','id="client-title"')}${tr('clientText','p')}</div><figure class="client-image"><img src="/assets/client-settings.png" width="1280" height="800" alt="${t('clientScreenshot')}" data-i18n-alt="clientScreenshot" loading="lazy">${tr('screenshotCaption','figcaption')}</figure><div class="client-details"><article>${tr('appearanceTitle','h3')}${tr('appearanceText','p')}</article><article>${tr('identityTitle','h3')}${tr('identityText','p')}</article></div></div></section>
|
||||||
|
<section class="roadmap shell" id="roadmap" aria-labelledby="roadmap-title"><div class="roadmap-heading">${tr('roadmapTitle','h2','id="roadmap-title"')}${tr('roadmapText','p')}</div><div class="roadmap-columns"><article><h3><span class="connection-dot" aria-hidden="true"></span>${tr('available')}</h3><ul><li>${tr('availableOne')}</li><li>${tr('availableTwo')}</li><li>${tr('availableThree')}</li><li>${tr('availableFour')}</li><li>${tr('availableFive')}</li></ul></article><article><h3><span class="planned-dot" aria-hidden="true"></span>${tr('next')}</h3><ul><li>${tr('nextOne')}</li><li>${tr('nextTwo')}</li><li>${tr('nextThree')}</li></ul></article></div>${tr('downloadNote','p','class="release-note"')}</section>
|
||||||
|
<section class="faq shell" aria-labelledby="faq-title">${tr('faqTitle','h2','id="faq-title"')}<div>${['Server','Central','Release'].map(key=>`<details><summary>${tr(`faq${key}`)}<span aria-hidden="true">+</span></summary>${tr(`faq${key}Answer`,'p')}</details>`).join('')}</div></section>
|
||||||
|
<section class="status-section shell" aria-label="${t('statusNote')}" data-i18n-aria="statusNote"><div><span id="service-dot" class="status-dot"></span><p id="service-status" role="status">${t('statusLoading')}</p></div><a href="/account" class="text-link">${tr('openCentral')}${icon('external',15)}</a></section>`;
|
||||||
|
renderDiagram();
|
||||||
|
main.querySelectorAll('[data-tab]').forEach(button => {
|
||||||
|
button.addEventListener('click', () => { activeTab = button.dataset.tab; renderDiagram(); });
|
||||||
|
button.addEventListener('keydown', event => {
|
||||||
|
const tabs = [...main.querySelectorAll('[data-tab]')];
|
||||||
|
let index = tabs.indexOf(button);
|
||||||
|
if (event.key === 'ArrowRight') index = (index + 1) % tabs.length;
|
||||||
|
else if (event.key === 'ArrowLeft') index = (index + tabs.length - 1) % tabs.length;
|
||||||
|
else if (event.key === 'Home') index = 0;
|
||||||
|
else if (event.key === 'End') index = tabs.length - 1;
|
||||||
|
else return;
|
||||||
|
event.preventDefault(); activeTab = tabs[index].dataset.tab; renderDiagram(); tabs[index].focus();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
}
|
||||||
|
function renderDiagram() {
|
||||||
|
const content = document.querySelector('#diagram-content');
|
||||||
|
if (!content) return;
|
||||||
|
main.querySelectorAll('[data-tab]').forEach(button => {
|
||||||
|
const active = button.dataset.tab === activeTab;
|
||||||
|
button.setAttribute('aria-selected', String(active));button.tabIndex = active ? 0 : -1;
|
||||||
|
});
|
||||||
|
content.setAttribute('role','tabpanel');content.setAttribute('aria-labelledby', `tab-${activeTab}`);
|
||||||
|
if (activeTab === 'text') content.innerHTML = `<div class="illustration-chat"><div class="message-heading"><span class="chat-avatar">V</span><div>${tr('community','strong')}<div class="message-lines" aria-hidden="true"><i></i><i></i></div></div></div>${tr('messageSample','p')}<div class="illustration-composer" aria-hidden="true"><span>+</span><i></i>${icon('chat',15)}</div>${tr('messageNote','p','class="diagram-caption"')}</div>`;
|
||||||
|
if (activeTab === 'voice') content.innerHTML = `<div class="illustration-voice"><div class="voice-orbit"><span class="voice-avatar">V</span><div class="waveform" aria-hidden="true">${Array.from({length:11},()=>'<i></i>').join('')}</div><span class="voice-avatar friend-avatar">${icon('voice',30)}</span></div>${tr('voiceExplain','p')}<div class="voice-controls" aria-hidden="true"><span>${icon('mic')}</span><span>${icon('voice')}</span></div>${tr('voiceCaption','p','class="diagram-caption"')}</div>`;
|
||||||
|
if (activeTab === 'theme') {
|
||||||
|
content.innerHTML = `<div class="illustration-themes">${tr('themeCaption','h3')}<div class="theme-options" role="group" aria-label="${t('previewTheme')}" data-i18n-aria="previewTheme">${['light','dark','black','custom'].map(theme=>`<button class="theme-option ${theme}" data-theme="${theme}" aria-pressed="${activeTheme===theme}"><span class="theme-sample" aria-hidden="true"><i></i><i></i><i></i></span>${tr(theme)}</button>`).join('')}</div></div>`;
|
||||||
|
content.querySelectorAll('[data-theme]').forEach(button => button.addEventListener('click',()=>{
|
||||||
|
activeTheme = button.dataset.theme;
|
||||||
|
document.querySelector('.product-diagram').dataset.previewTheme = activeTheme;
|
||||||
|
content.querySelectorAll('[data-theme]').forEach(item=>item.setAttribute('aria-pressed',String(item===button)));
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function account() {
|
||||||
|
main.innerHTML = `<section class="account-section shell"><a href="/" class="text-link back-link">${icon('back',17)}${tr('back')}</a><div class="account-layout"><div class="account-intro"><img class="account-mark" src="/assets/vnox-mark.svg" alt="" width="76" height="76">${tr('accountHeading','h1')}${tr('accountIntro','p')}<div class="account-explanation">${tr('accountStage','p')}</div></div><div id="account-content" class="account-panel" aria-live="polite"></div></div></section>`;
|
||||||
|
renderAccount();
|
||||||
|
}
|
||||||
|
function renderAccount() {
|
||||||
|
const panel = document.querySelector('#account-content');
|
||||||
|
if (!panel) return;
|
||||||
|
panel.replaceChildren();
|
||||||
|
if (sessionState === 'loading') { panel.innerHTML = `<div class="account-loading"><span class="loading-ring" aria-hidden="true"></span>${tr('sessionLoading','p')}</div>`;return; }
|
||||||
|
if (sessionState === 'error') {
|
||||||
|
panel.innerHTML = `${tr('accountError','h2')}${tr('accountErrorText','p')}<button class="button primary" id="retry-session">${tr('retry')}</button>`;
|
||||||
|
panel.querySelector('#retry-session').addEventListener('click',refresh);return;
|
||||||
|
}
|
||||||
|
if (currentSession?.authenticated) {
|
||||||
|
panel.innerHTML = `<div class="profile-heading"><div class="profile-avatar" id="profile-avatar" aria-hidden="true">V</div><div>${tr('profileTitle','h2')}<p id="profile-name"></p></div></div>${tr('profileIntro','p')}<dl class="profile-fields"><div><dt>${tr('handle')}</dt><dd id="profile-handle"></dd></div><div><dt>${tr('userId')}</dt><dd id="profile-id"></dd></div><div><dt>${tr('provider')}</dt><dd>GitHub</dd></div></dl><div class="profile-actions"><button class="button secondary" id="copy-id">${icon('copy',17)}${tr('copy')}</button><button class="button quiet" id="logout" ${logoutState==='pending'?'disabled':''}>${tr(logoutState==='pending'?'loggingOut':'logout')}</button></div><p class="form-message" id="profile-message" role="status"></p>`;
|
||||||
|
const user = currentSession.user;
|
||||||
|
panel.querySelector('#profile-name').textContent = user.display_name || t('profileFallback');
|
||||||
|
panel.querySelector('#profile-handle').textContent = user.handle;
|
||||||
|
panel.querySelector('#profile-id').textContent = user.user_id;
|
||||||
|
const avatar = safeAvatar(user.avatar_url);
|
||||||
|
if (avatar) { const image = document.createElement('img');image.src=avatar;image.alt='';image.referrerPolicy='no-referrer';image.addEventListener('error',()=>image.remove(),{once:true});panel.querySelector('#profile-avatar').append(image); }
|
||||||
|
panel.querySelector('#copy-id').addEventListener('click',async()=>{
|
||||||
|
try { await navigator.clipboard.writeText(user.user_id); panel.querySelector('#profile-message').textContent=t('copied'); }
|
||||||
|
catch { panel.querySelector('#profile-message').textContent=t('copyError'); }
|
||||||
|
});
|
||||||
|
panel.querySelector('#logout').addEventListener('click',logout);
|
||||||
|
if (logoutState==='error') panel.querySelector('#profile-message').textContent=t('logoutError');
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
panel.innerHTML = `<div class="login-provider">${icon('github',33)}</div>${tr('loginTitle','h2')}${tr('loginText','p')}<a class="button primary github-login ${githubEnabled?'':'unavailable'}" ${githubEnabled?'href="/v1/auth/github/start"':'aria-disabled="true" tabindex="-1"'}>${icon('github',21)}${tr('loginButton')}</a><p id="login-availability" class="form-message" role="status"></p><button class="text-button" id="retry-info" ${infoState==='error'?'':'hidden'}>${tr('retry')}</button><div class="privacy-note">${icon('check',16)}${tr('privacy','p')}</div>`;
|
||||||
|
panel.querySelector('#login-availability').textContent = infoState==='loading'?t('loginLoading'):infoState==='error'?t('loginUnavailable'):githubEnabled?'':t('loginDisabled');
|
||||||
|
panel.querySelector('#retry-info').addEventListener('click',refresh);
|
||||||
|
}
|
||||||
|
async function logout() {
|
||||||
|
if (!currentSession?.authenticated || logoutState==='pending') return;
|
||||||
|
const csrf = currentSession.csrf_token;
|
||||||
|
logoutState='pending';renderAccount();
|
||||||
|
try {
|
||||||
|
await request('/v1/auth/logout',{method:'POST',csrf,signal:AbortSignal.timeout(15000)});
|
||||||
|
currentSession={authenticated:false};logoutState='idle';renderAccount();
|
||||||
|
} catch(error) {
|
||||||
|
if (error.status===401) { currentSession={authenticated:false};logoutState='idle';renderAccount(); }
|
||||||
|
else { logoutState='error';renderAccount(); }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function updateStatus() {
|
||||||
|
const status = document.querySelector('#service-status');
|
||||||
|
if (status) { status.textContent = t(infoState==='loading'?'statusLoading':infoState==='ready'?'statusReady':'statusUnavailable');document.querySelector('#service-dot').dataset.state=infoState; }
|
||||||
|
}
|
||||||
|
async function refresh() {
|
||||||
|
controller?.abort();controller=new AbortController();
|
||||||
|
const currentController = controller;
|
||||||
|
const signal = AbortSignal.any([currentController.signal,AbortSignal.timeout(15000)]);
|
||||||
|
infoState='loading';
|
||||||
|
if (accountPage) { sessionState='loading';renderAccount(); } else updateStatus();
|
||||||
|
const info = request('/v1/info',{signal}).then(value=>{
|
||||||
|
if (controller !== currentController) return;
|
||||||
|
if (typeof value?.capabilities?.github_auth !== 'string') throw new Error('invalid_info');
|
||||||
|
githubEnabled=value.capabilities.github_auth==='enabled';infoState='ready';
|
||||||
|
}).catch(()=>{if(!currentController.signal.aborted){githubEnabled=false;infoState='error';}}).finally(()=>{if(controller===currentController){updateStatus();if(accountPage)renderAccount();}});
|
||||||
|
if (accountPage) {
|
||||||
|
await Promise.allSettled([info,request('/v1/auth/session',{signal}).then(value=>{
|
||||||
|
if (controller !== currentController) return;
|
||||||
|
if (!isSession(value)) throw new Error('invalid_session');
|
||||||
|
currentSession=value;sessionState='ready';
|
||||||
|
}).catch(()=>{if(!currentController.signal.aborted)sessionState='error';}).finally(()=>{if(controller===currentController)renderAccount();})]);
|
||||||
|
} else await info;
|
||||||
|
}
|
||||||
|
function setLanguage(next) {
|
||||||
|
language=next;
|
||||||
|
try { localStorage.setItem('vnox-web-language',next); } catch { /* No authentication data is persisted. */ }
|
||||||
|
document.documentElement.lang=next;
|
||||||
|
document.title=t(accountPage?'accountTitle':'title');
|
||||||
|
document.querySelector('meta[name="description"]').content=t('description');
|
||||||
|
document.querySelectorAll('[data-i18n]').forEach(element=>element.textContent=t(element.dataset.i18n));
|
||||||
|
for(const [attribute,dataKey] of [['aria-label','i18nAria'],['alt','i18nAlt']]) document.querySelectorAll(`[data-${attribute==='alt'?'i18n-alt':'i18n-aria'}]`).forEach(element=>element.setAttribute(attribute,t(element.dataset[dataKey])));
|
||||||
|
document.querySelectorAll('[data-language]').forEach(button=>button.setAttribute('aria-pressed',String(button.dataset.language===next)));
|
||||||
|
if (accountPage) renderAccount();else {renderDiagram();updateStatus();}
|
||||||
|
}
|
||||||
|
if(accountPage) account();else landing();
|
||||||
|
document.querySelectorAll('[data-language]').forEach(button=>button.addEventListener('click',()=>setLanguage(button.dataset.language)));
|
||||||
|
setLanguage(language);refresh();
|
||||||
|
window.addEventListener('pageshow',event=>{if(event.persisted)refresh();});
|
||||||
31
src/i18n.js
Normal file
31
src/i18n.js
Normal file
|
|
@ -0,0 +1,31 @@
|
||||||
|
export const messages = {
|
||||||
|
ru: {
|
||||||
|
skip:'Перейти к содержимому', nav:'Основная навигация', navProject:'Проект', navClient:'Клиент', navRoadmap:'Дальше', language:'Язык', account:'Аккаунт', footer:'Сделано для разговоров, которые хочется продолжать.', source:'Исходный код',
|
||||||
|
title:'VNOX — Своя связь', accountTitle:'Аккаунт — VNOX Central', description:'VNOX — голос и чат для своих сообществ. Нативный клиент, собственный сервер и открытый код.',
|
||||||
|
development:'В открытой разработке', heroTitle:'Свои люди.\nСвоя связь.', heroText:'Место для вашего сообщества. Обсуждайте планы, оставайтесь в голосе и управляйте своим сервером сами.', openCentral:'Открыть Vnox Central', explore:'О проекте', earlyNote:'Ранняя версия. Разрабатываем открыто, без обещаний на вырост.',
|
||||||
|
diagramLabel:'Схема общения', diagramNote:'Иллюстрация устройства клиента', textTab:'Текст', voiceTab:'Голос', themeTab:'Внешний вид', community:'Ваше сообщество', general:'общий', ideas:'идеи', voiceRoom:'Вечерний войс', voiceConnected:'Голос остаётся с вами', voiceExplain:'Переключайте текстовые каналы, не выходя из разговора.', you:'Вы', friend:'Друг', messageSample:'Общий чат для идей, ссылок и планов.', messageNote:'Чат и голос доступны в одном окне.', voiceCaption:'Отдельное управление микрофоном и звуком.', themeCaption:'Четыре варианта. Один ваш.', light:'Светлая', dark:'Тёмная', black:'Мега-тёмная', custom:'Своя', preview:'Предпросмотр', previewTheme:'Тема иллюстрации',
|
||||||
|
projectTitle:'Одно приложение.\nВаш сервер.', projectText:'VNOX объединяет текст и голос в нативном клиенте. Сервер сообщества запускается одним приложением и остаётся под управлением его владельца.', projectNative:'Нативный клиент', projectNativeText:'Написан на Rust и Slint. Настройки звука, профиля и внешнего вида собраны в одном месте.', projectServer:'Сервер сообщества', projectServerText:'Текстовые каналы и голос в одном серверном приложении. Владелец выбирает, где его запускать.', projectCentral:'Vnox Central', projectCentralText:'Центральный сервис для аккаунта. Каталог серверов и друзья — следующие этапы разработки.', clientCode:'Код клиента', serverCode:'Код сервера',
|
||||||
|
clientTitle:'Удобство начинается\nс простых вещей.', clientText:'Светлая, тёмная, мега-тёмная или собственная тема. Размер текста, звук и профиль — там, где их ожидаешь найти.', clientScreenshot:'Настройки внешнего вида нативного клиента VNOX: четыре темы и размер текста.', screenshotCaption:'Настоящий снимок нативного клиента. Интерфейс продолжает развиваться.', appearanceTitle:'Внешний вид — ваш', appearanceText:'Своя палитра через поддерживаемые CSS-переменные. Без загрузки внешних ресурсов.', identityTitle:'Профиль без суеты', identityText:'Выберите фотографию, настройте масштаб и положение в круглом предпросмотре.',
|
||||||
|
roadmapTitle:'Сначала надёжная связь.\nПотом всё остальное.', roadmapText:'Проект ещё в разработке. Здесь разделены доступные части и то, над чем мы работаем.', available:'Уже в коде', next:'В работе и планах', availableOne:'Нативный клиент, каналы и голос', availableTwo:'Настройки, темы и редактор аватара', availableThree:'Центральный сервис и защищённое соединение', availableFour:'Веб-аккаунт GitHub и интерфейс RU / EN', availableFive:'Входящие и подписанные исходящие вебхуки на сервере', nextOne:'Управление вебхуками в клиенте', nextTwo:'Трансляция экрана с раздельным звуком', nextThree:'Друзья и поиск серверов', downloadNote:'Публичные сборки появятся после проверки совместимости клиента и сервера. Пока доступны исходники.',
|
||||||
|
faqTitle:'До первого разговора', faqServer:'Нужен ли отдельный голосовой сервер?', faqServerAnswer:'Нет. Для сообщества планируется одно серверное приложение, которое включает чат и голос.', faqCentral:'Зачем нужен Vnox Central?', faqCentralAnswer:'Для общего аккаунта и будущих социальных функций. Само сообщество размещает свой сервер отдельно.', faqRelease:'Где скачать клиент?', faqReleaseAnswer:'Проверенного публичного релиза пока нет. Код клиента и сервера открыт; инструкции по сборке находятся в их репозиториях.',
|
||||||
|
statusLoading:'Проверяем Vnox Central…', statusReady:'Vnox Central отвечает', statusUnavailable:'Не удалось связаться с Vnox Central', statusNote:'Состояние центрального сервиса', retry:'Повторить',
|
||||||
|
back:'На главную', accountHeading:'Ваш Vnox Central.', accountIntro:'Один аккаунт для будущих сообществ. Начните с безопасного входа через GitHub.', loginTitle:'Продолжить с GitHub', loginText:'VNOX получает ваш публичный профиль GitHub. Доступ к репозиториям для входа не запрашивается.', loginButton:'Войти через GitHub', loginLoading:'Проверяем возможность входа…', loginDisabled:'Вход через GitHub пока не включён на сервере.', loginUnavailable:'Не удалось проверить доступность входа. Повторите попытку.', privacy:'Авторизация происходит на github.com. Пароль GitHub остаётся у GitHub.', accountStage:'Центральный аккаунт пока не привязывается к локальным ключам настольного клиента. Друзья, серверы и сообщения появятся позже.', sessionLoading:'Загружаем аккаунт…', profileTitle:'Вы на связи.', profileIntro:'Вход через GitHub выполнен. Это ваш центральный аккаунт VNOX.', handle:'Имя аккаунта', userId:'ID аккаунта', provider:'Способ входа', logout:'Выйти из аккаунта', loggingOut:'Выходим…', logoutError:'Не удалось выйти. Повторите попытку.', sessionExpired:'Сессия завершилась. Войдите снова.', profileFallback:'Пользователь VNOX', accountError:'Аккаунт сейчас недоступен', accountErrorText:'Не удалось загрузить сессию. Проверьте соединение и повторите попытку.', copy:'Скопировать ID', copied:'ID скопирован', copyError:'Не удалось скопировать ID. Выделите его вручную.',
|
||||||
|
},
|
||||||
|
en: {
|
||||||
|
skip:'Skip to content', nav:'Main navigation', navProject:'Project', navClient:'Client', navRoadmap:'What’s next', language:'Language', account:'Account', footer:'Made for conversations you want to continue.', source:'Source code',
|
||||||
|
title:'VNOX — Your own connection', accountTitle:'Account — VNOX Central', description:'VNOX brings voice and chat to your community. Native client, your own server, open source.',
|
||||||
|
development:'In open development', heroTitle:'Your people.\nYour connection.', heroText:'A place for your community. Share your plans, stay in voice and run your server on your terms.', openCentral:'Open Vnox Central', explore:'Explore the project', earlyNote:'An early version, developed in the open.',
|
||||||
|
diagramLabel:'How you stay connected', diagramNote:'An illustration of the client layout', textTab:'Text', voiceTab:'Voice', themeTab:'Appearance', community:'Your community', general:'general', ideas:'ideas', voiceRoom:'Evening voice', voiceConnected:'Voice stays with you', voiceExplain:'Browse text channels without leaving the conversation.', you:'You', friend:'Friend', messageSample:'A shared chat for ideas, links and plans.', messageNote:'Chat and voice, together in one window.', voiceCaption:'Separate controls for your microphone and sound.', themeCaption:'Four options. One that’s yours.', light:'Light', dark:'Dark', black:'Mega dark', custom:'Custom', preview:'Preview', previewTheme:'Illustration theme',
|
||||||
|
projectTitle:'One application.\nYour own server.', projectText:'VNOX brings text and voice together in a native client. One server application runs your community, under its owner’s control.', projectNative:'Native client', projectNativeText:'Built with Rust and Slint. Audio, profile and appearance settings, all in one place.', projectServer:'Community server', projectServerText:'Text channels and voice in one server application. Its owner chooses where to run it.', projectCentral:'Vnox Central', projectCentralText:'The central service for your account. Server discovery and friends are the next stages.', clientCode:'Client source', serverCode:'Server source',
|
||||||
|
clientTitle:'Comfort starts\nwith simple things.', clientText:'Light, dark, mega dark or your own theme. Text size, audio and your profile, right where you expect them.', clientScreenshot:'Appearance settings in the native VNOX client, with four themes and a text size slider.', screenshotCaption:'A real screenshot of the native client. The interface is still evolving.', appearanceTitle:'Make it yours', appearanceText:'Create your palette with supported CSS variables. No external resources are loaded.', identityTitle:'A profile without the fuss', identityText:'Choose a photo, then adjust its zoom and position inside a circular preview.',
|
||||||
|
roadmapTitle:'Reliable conversation first.\nThe rest comes next.', roadmapText:'VNOX is still being developed. Here is what exists in the code and what we’re building next.', available:'Already in the code', next:'In progress and planned', availableOne:'Native client, channels and voice', availableTwo:'Settings, themes and avatar editor', availableThree:'Central service and HTTPS', availableFour:'GitHub web account and RU / EN interface', availableFive:'Incoming and signed outgoing server webhooks', nextOne:'Webhook management in the client', nextTwo:'Screen broadcasting with separate audio sources', nextThree:'Friends and server discovery', downloadNote:'Public builds will follow client and server compatibility checks. Source code is available now.',
|
||||||
|
faqTitle:'Before the first conversation', faqServer:'Do I need a separate voice server?', faqServerAnswer:'No. A community is intended to run one server application with both chat and voice.', faqCentral:'What is Vnox Central for?', faqCentralAnswer:'Your shared account and future social features. Each community hosts its own server separately.', faqRelease:'Where can I download the client?', faqReleaseAnswer:'There is no verified public release yet. Client and server code is open, with build instructions in their repositories.',
|
||||||
|
statusLoading:'Checking Vnox Central…', statusReady:'Vnox Central is responding', statusUnavailable:'Could not reach Vnox Central', statusNote:'Central service status', retry:'Try again',
|
||||||
|
back:'Back to home', accountHeading:'Your Vnox Central.', accountIntro:'One account for future communities. Start with secure GitHub sign-in.', loginTitle:'Continue with GitHub', loginText:'VNOX receives your public GitHub profile. Signing in does not request access to your repositories.', loginButton:'Sign in with GitHub', loginLoading:'Checking sign-in availability…', loginDisabled:'GitHub sign-in is not enabled on the server yet.', loginUnavailable:'Could not check sign-in availability. Try again.', privacy:'You authorize on github.com. Your GitHub password stays with GitHub.', accountStage:'Your central account is not yet linked to the desktop client’s local keys. Friends, servers and messages will follow.', sessionLoading:'Loading your account…', profileTitle:'You’re connected.', profileIntro:'Signed in with GitHub. This is your central VNOX account.', handle:'Account handle', userId:'Account ID', provider:'Signed in with', logout:'Sign out', loggingOut:'Signing out…', logoutError:'Could not sign out. Try again.', sessionExpired:'Your session ended. Sign in again.', profileFallback:'VNOX user', accountError:'Your account is currently unavailable', accountErrorText:'Could not load your session. Check your connection and try again.', copy:'Copy account ID', copied:'Account ID copied', copyError:'Could not copy the ID. Select it manually.',
|
||||||
|
},
|
||||||
|
};
|
||||||
|
export function detectLanguage(saved, languages = []) {
|
||||||
|
if (saved === 'ru' || saved === 'en') return saved;
|
||||||
|
return languages.some(value => /^ru(?:-|$)/i.test(value)) ? 'ru' : 'en';
|
||||||
|
}
|
||||||
|
export function translate(language, key) { return messages[language]?.[key] ?? messages.en[key] ?? key; }
|
||||||
9
src/styles.css
Normal file
9
src/styles.css
Normal file
File diff suppressed because one or more lines are too long
43
tests/api.test.js
Normal file
43
tests/api.test.js
Normal file
|
|
@ -0,0 +1,43 @@
|
||||||
|
import test from 'node:test';
|
||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import { request, isSession, safeAvatar, ApiError } from '../src/api.js';
|
||||||
|
import { messages, detectLanguage } from '../src/i18n.js';
|
||||||
|
|
||||||
|
test('catalogs match and never silently fall back to a missing translation',()=>{
|
||||||
|
assert.deepEqual(Object.keys(messages.ru).sort(),Object.keys(messages.en).sort());
|
||||||
|
for (const catalog of Object.values(messages)) for (const value of Object.values(catalog)) assert.ok(typeof value==='string' && value.length>0);
|
||||||
|
});
|
||||||
|
test('language preference is bounded and follows the OS without storage',()=>{
|
||||||
|
assert.equal(detectLanguage('en',['ru-RU']),'en');
|
||||||
|
assert.equal(detectLanguage('bad',['ru-RU']),'ru');
|
||||||
|
assert.equal(detectLanguage(undefined,['pl-PL']),'en');
|
||||||
|
assert.equal(detectLanguage('RU',['en-US']),'en');
|
||||||
|
});
|
||||||
|
test('API keeps authentication on the same origin and sends CSRF only in header',async()=>{
|
||||||
|
let observed;
|
||||||
|
const result=await request('/v1/auth/logout',{method:'POST',csrf:'fixture-csrf',fetcher:async(path,options)=>{
|
||||||
|
observed={path,options};return {ok:true,status:204};
|
||||||
|
}});
|
||||||
|
assert.equal(result,null);
|
||||||
|
assert.equal(observed.path,'/v1/auth/logout');
|
||||||
|
assert.equal(observed.options.credentials,'same-origin');
|
||||||
|
assert.equal(observed.options.cache,'no-store');
|
||||||
|
assert.equal(observed.options.headers['X-CSRF-Token'],'fixture-csrf');
|
||||||
|
assert.equal(observed.options.method,'POST');
|
||||||
|
await assert.rejects(request('https://evil.example/v1/auth/session'),TypeError);
|
||||||
|
await assert.rejects(request('//evil.example/v1/auth/session'),TypeError);
|
||||||
|
});
|
||||||
|
test('API failures expose a generic code and preserve status for expired sessions',async()=>{
|
||||||
|
await assert.rejects(request('/v1/auth/session',{fetcher:async()=>({ok:false,status:401})}),error=>error instanceof ApiError && error.status===401 && error.message==='request_failed');
|
||||||
|
});
|
||||||
|
test('session validation rejects malformed authenticated payloads',()=>{
|
||||||
|
assert.ok(isSession({authenticated:false}));
|
||||||
|
assert.ok(isSession({authenticated:true,csrf_token:'fixture',user:{user_id:'fixture',handle:'test',display_name:'Test'}}));
|
||||||
|
assert.equal(isSession({authenticated:true,user:{}}),false);
|
||||||
|
assert.equal(isSession({authenticated:'true'}),false);
|
||||||
|
assert.equal(isSession({authenticated:true,csrf_token:'',user:{user_id:'fixture',handle:'test',display_name:'Test'}}),false);
|
||||||
|
});
|
||||||
|
test('avatars allow only uncredentialed HTTPS GitHub image origin',()=>{
|
||||||
|
assert.equal(safeAvatar('https://avatars.githubusercontent.com/u/1?v=4'),'https://avatars.githubusercontent.com/u/1?v=4');
|
||||||
|
for (const url of ['javascript:alert(1)','data:image/svg+xml,<svg/>','http://avatars.githubusercontent.com/u/1','https://avatars.githubusercontent.com.evil.example/u/1','https://evil@avatars.githubusercontent.com/u/1','https://avatars.githubusercontent.com:8443/u/1','https://evil.example/u/1',null]) assert.equal(safeAvatar(url),null);
|
||||||
|
});
|
||||||
104
tests/browser_qa.py
Normal file
104
tests/browser_qa.py
Normal file
|
|
@ -0,0 +1,104 @@
|
||||||
|
"""Optional browser integration QA. Requires locally installed Playwright + Chromium.
|
||||||
|
Run with an already running npm run dev/preview. All API responses are test fixtures.
|
||||||
|
"""
|
||||||
|
import argparse
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
from urllib.parse import urlparse
|
||||||
|
from playwright.sync_api import sync_playwright
|
||||||
|
|
||||||
|
parser = argparse.ArgumentParser()
|
||||||
|
parser.add_argument('--url', default='http://127.0.0.1:4176')
|
||||||
|
parser.add_argument('--artifacts', default='/tmp/vnox-web-qa')
|
||||||
|
args = parser.parse_args()
|
||||||
|
if urlparse(args.url).hostname not in {'127.0.0.1', 'localhost', '::1'}:
|
||||||
|
raise SystemExit('Browser fixture QA is restricted to a loopback preview.')
|
||||||
|
artifacts = Path(args.artifacts)
|
||||||
|
artifacts.mkdir(parents=True, exist_ok=True)
|
||||||
|
|
||||||
|
with sync_playwright() as p:
|
||||||
|
browser = p.chromium.launch(executable_path='/usr/bin/chromium', headless=True, args=['--no-sandbox'])
|
||||||
|
context = browser.new_context(viewport={'width': 1440, 'height': 1000}, locale='ru-RU')
|
||||||
|
state = {'info': {'capabilities': {'github_auth': 'enabled'}}, 'session': {'authenticated': False}, 'info_status': 200, 'session_status': 200, 'logout_status': 204}
|
||||||
|
logouts = []
|
||||||
|
def api(route):
|
||||||
|
path = urlparse(route.request.url).path
|
||||||
|
if path == '/v1/info': route.fulfill(status=state['info_status'], json=state['info'])
|
||||||
|
elif path == '/v1/auth/session': route.fulfill(status=state['session_status'], json=state['session'])
|
||||||
|
elif path == '/v1/auth/logout':
|
||||||
|
logouts.append({'method': route.request.method, 'headers': route.request.all_headers()})
|
||||||
|
route.fulfill(status=state['logout_status'], body='' if state['logout_status'] == 204 else '{}')
|
||||||
|
else: route.fulfill(status=404, json={'error': 'fixture_not_found'})
|
||||||
|
context.route('**/v1/**', api)
|
||||||
|
page = context.new_page()
|
||||||
|
errors = []
|
||||||
|
page.on('pageerror', lambda error: errors.append(str(error)))
|
||||||
|
page.goto(args.url)
|
||||||
|
page.locator('#service-status').filter(has_text='отвечает').wait_for()
|
||||||
|
page.screenshot(path=str(artifacts / 'desktop-hero.png'))
|
||||||
|
page.screenshot(path=str(artifacts / 'desktop-full.png'), full_page=True)
|
||||||
|
page.locator('[data-tab="voice"]').click()
|
||||||
|
assert page.locator('.voice-orbit').count() == 1
|
||||||
|
page.locator('[data-tab="voice"]').press('ArrowRight')
|
||||||
|
assert page.locator('[data-tab="theme"]').get_attribute('aria-selected') == 'true'
|
||||||
|
page.locator('[data-theme="light"]').click()
|
||||||
|
assert page.locator('.product-diagram').get_attribute('data-preview-theme') == 'light'
|
||||||
|
page.locator('[data-language="en"]').click()
|
||||||
|
assert page.locator('h1').inner_text() == 'Your people.\nYour connection.'
|
||||||
|
assert page.locator('[data-tab="theme"]').get_attribute('aria-selected') == 'true'
|
||||||
|
assert page.locator('[data-theme="light"]').get_attribute('aria-pressed') == 'true'
|
||||||
|
for locale in ['en', 'ru']:
|
||||||
|
page.locator(f'[data-language="{locale}"]').click()
|
||||||
|
for width in [320, 390, 768, 1440]:
|
||||||
|
page.set_viewport_size({'width': width, 'height': 844})
|
||||||
|
assert not page.evaluate('document.documentElement.scrollWidth > innerWidth'), (locale, width)
|
||||||
|
page.set_viewport_size({'width': 390, 'height': 844})
|
||||||
|
page.screenshot(path=str(artifacts / 'mobile-full.png'), full_page=True)
|
||||||
|
page.goto(args.url + '/account')
|
||||||
|
page.locator('.github-login[href="/v1/auth/github/start"]').wait_for()
|
||||||
|
assert page.locator('.github-login').get_attribute('aria-disabled') is None
|
||||||
|
page.screenshot(path=str(artifacts / 'account-login-mobile.png'), full_page=True)
|
||||||
|
state['info'] = {'capabilities': {'github_auth': 'not_enabled'}}
|
||||||
|
page.reload()
|
||||||
|
page.locator('#login-availability').filter(has_text='не включён').wait_for()
|
||||||
|
assert page.locator('.github-login').get_attribute('href') is None
|
||||||
|
state['info_status'] = 503
|
||||||
|
page.reload()
|
||||||
|
page.locator('#retry-info:not([hidden])').wait_for()
|
||||||
|
state['session_status'] = 503
|
||||||
|
page.reload()
|
||||||
|
page.locator('#retry-session').wait_for()
|
||||||
|
state['info_status'] = 200
|
||||||
|
state['session_status'] = 200
|
||||||
|
state['info'] = {'capabilities': {'github_auth': 'enabled'}}
|
||||||
|
state['session'] = {'authenticated': True, 'csrf_token': 'fixture-csrf-token', 'user': {'user_id': 'fixture-id', 'handle': '<script>window.__injected=true</script>', 'display_name': '<img src=x onerror="window.__injected=true">', 'avatar_url': 'javascript:alert(1)'}}
|
||||||
|
page.locator('#retry-session').click()
|
||||||
|
page.locator('#profile-id').wait_for()
|
||||||
|
assert page.locator('#profile-name').inner_text() == state['session']['user']['display_name']
|
||||||
|
assert page.locator('#profile-name img, #profile-handle script, #profile-avatar img').count() == 0
|
||||||
|
assert page.evaluate('typeof window.__injected') == 'undefined'
|
||||||
|
assert page.evaluate('Object.keys(localStorage)') == ['vnox-web-language']
|
||||||
|
state['session']['user'] = {'user_id': 'c11ca6c3-296a-40f6-a420-8a097d401e26', 'handle': 'u_preview', 'display_name': 'VNOX Preview', 'avatar_url': None}
|
||||||
|
page.reload()
|
||||||
|
page.locator('#profile-id').wait_for()
|
||||||
|
page.set_viewport_size({'width': 1440, 'height': 1000})
|
||||||
|
page.screenshot(path=str(artifacts / 'account-profile-desktop.png'))
|
||||||
|
for locale in ['ru', 'en']:
|
||||||
|
page.locator(f'[data-language="{locale}"]').click()
|
||||||
|
for width in [320,390,768,1440]:
|
||||||
|
page.set_viewport_size({'width':width,'height':844})
|
||||||
|
assert not page.evaluate('document.documentElement.scrollWidth > innerWidth'), ('account',locale,width)
|
||||||
|
page.locator('#logout').click()
|
||||||
|
page.locator('.github-login').wait_for()
|
||||||
|
assert logouts[-1]['method'] == 'POST'
|
||||||
|
assert logouts[-1]['headers']['x-csrf-token'] == 'fixture-csrf-token'
|
||||||
|
assert logouts[-1]['headers']['origin'] == args.url
|
||||||
|
assert page.evaluate('sessionStorage.length') == 0
|
||||||
|
state['logout_status'] = 401
|
||||||
|
page.reload()
|
||||||
|
page.locator('#profile-id').wait_for()
|
||||||
|
page.locator('#logout').click()
|
||||||
|
page.locator('.github-login').wait_for()
|
||||||
|
assert not errors, errors
|
||||||
|
browser.close()
|
||||||
|
print(json.dumps({'result':'passed','assertions':'tabs, theme, RU/EN, 320/390/768/1440 layout, login enabled/disabled/errors, session/profile XSS safety, CSRF logout/expired session, no persisted secrets','artifacts':str(artifacts)}))
|
||||||
16
tests/server.test.js
Normal file
16
tests/server.test.js
Normal file
|
|
@ -0,0 +1,16 @@
|
||||||
|
import test from 'node:test';
|
||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import { spawn } from 'node:child_process';
|
||||||
|
import { once } from 'node:events';
|
||||||
|
import http from 'node:http';
|
||||||
|
function fetchRaw(port,path){return new Promise((resolve,reject)=>{http.get({host:'127.0.0.1',port,path},response=>{let body='';response.on('data',chunk=>body+=chunk);response.on('end',()=>resolve({status:response.statusCode,body}));}).on('error',reject);});}
|
||||||
|
test('preview serves only public/source assets and blocks encoded traversal',async t=>{
|
||||||
|
const port=24176;
|
||||||
|
const process=spawn(globalThis.process.execPath,['scripts/serve.mjs'],{env:{...globalThis.process.env,PORT:String(port)},stdio:['ignore','pipe','pipe']});
|
||||||
|
t.after(()=>process.kill('SIGTERM'));
|
||||||
|
await Promise.race([once(process.stdout,'data'),once(process,'exit').then(()=>{throw new Error('preview failed to start');})]);
|
||||||
|
for(const path of ['/','/account','/account/','/src/app.js','/assets/vnox-mark.png']) assert.equal((await fetchRaw(port,path)).status,200,path);
|
||||||
|
for(const path of ['/src/%2e%2e%2fpackage.json','/src/%2e%2e%2f.env','/src/%2e%2e%2fLICENSE']) assert.equal((await fetchRaw(port,path)).status,403,path);
|
||||||
|
assert.equal((await fetchRaw(port,'/package.json')).status,404);
|
||||||
|
assert.equal((await fetchRaw(port,'/v1/auth/session')).status,503);
|
||||||
|
});
|
||||||
Loading…
Add table
Add a link
Reference in a new issue