Δομή Presence

Κατανόησε την απαιτούμενη διάταξη φακέλων για ένα presence Nowly.

Διάταξη Φακέλων

Ένα presence βρίσκεται μέσα στο src, ομαδοποιημένο κατά το πρώτο γράμμα του ονόματός του:

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
`-- assets/
    |-- logo.png
    |-- icon.png
    `-- thumbnail.jpg

metadata.json

Το metadata.json περιγράφει την πλατφόρμα, τα υποστηριζόμενα URL, τον δημιουργό, την κατηγορία, τις μεταφρασμένες περιγραφές, τα assets του marketplace και προαιρετικές σημαίες όπως το discordNative.

presence.ts

Το presence.ts περιέχει τη λογική εκτέλεσης. Εντοπίζει την κατάσταση της σελίδας και καλεί το Presence API.

utils/

Για σύνθετα presences, χώρισε τη λογική σου σε αποκλειστικά αρχεία μέσα σε έναν φάκελο utils/. Το presence του YouTube, για παράδειγμα, οργανώνει βοηθητικές συναρτήσεις DOM, ανάλυση καναλιού και επίλυση Shorts σε ξεχωριστά modules:

src/Y/YouTube/
|-- metadata.json
|-- presence.ts
|-- assets/
|   |-- logo.png
|   |-- icon.png
|   `-- thumbnail.jpg
`-- utils/
    |-- categories.ts
    |-- dom.ts
    |-- channel.ts
    |-- text.ts
    |-- bridge.ts
    |-- shorts-dom.ts
    |-- shorts-resolve.ts
    `-- youtube-data.ts

Ο bundler επιλύει τοπικά imports από το presence.ts, οπότε μπορείς να κάνεις import τα αρχεία utilities κανονικά:

import { findVideo } from "./utils/dom"
import { getChannelInfo } from "./utils/channel"

assets

Τα assets χρησιμοποιούνται από το marketplace, το εγκατεστημένο πακέτο presence, τα payloads δραστηριότητας του Discord και τις εικόνες Open Graph.

Απαιτούμενα αρχεία:

Αυτές οι διαστάσεις είναι ακριβείς απαιτήσεις, ελεγμένες από το CI σε κάθε PR presence - δες Assets για λεπτομέρειες.