Editing SimTX API/Extension catalog protocol (section)

== Entries ==
A catalog entry has a numeric ID, a '''kind''', a name, an author, a revision number and a set of text files.

{| class="wikitable"
! Kind !! Content
|-
| <code>extension</code> || A Lua extension package: an <code>extension.properties</code> manifest and one or more <code>.lua</code> files.
|-
| <code>preset</code> || A station preset: exactly one <code>.stxpreset</code> file.
|}

Extensions also report their package ID, version, dependencies and [[SimTX API/Data types#Catalog type|types]], read from the manifest at upload time.

=== Ownership and revisions ===
Entry names are unique on a server, compared without regard to case. The account that first publishes a name owns it.
* When the owner uploads an entry with the same name again, the existing entry is replaced: it keeps its ID, its files are replaced, and its revision increases by one. The [[SimTX API/Packets/CatalogUploadResult|CatalogUploadResult]] has <code>updated = true</code>.
* When another account uploads that name, the upload fails with [[SimTX API/Packets/Error|Error]] <code>FORBIDDEN</code>: ''An item named 'X' already exists (by Author)''.
* An extension's package ID must also be unique across the catalog and cannot change between revisions.
* Only the owner can delete an entry. There is no protocol-level override.