import * as dotenv from '@std/dotenv'; import { getPublicKey, nip19 } from 'nostr-tools'; import { z } from 'zod'; /** Load environment config from `.env` */ await dotenv.load({ export: true, defaultsPath: null, examplePath: null, }); /** Application-wide configuration. */ class Conf { private static _pubkey: string | undefined; /** Ditto admin secret key in nip19 format. This is the way it's configured by an admin. */ static get nsec(): `nsec1${string}` { const value = Deno.env.get('DITTO_NSEC'); if (!value) { throw new Error('Missing DITTO_NSEC'); } if (!value.startsWith('nsec1')) { throw new Error('Invalid DITTO_NSEC'); } return value as `nsec1${string}`; } /** Ditto admin secret key in hex format. */ static get seckey(): Uint8Array { return nip19.decode(Conf.nsec).data; } /** Ditto admin public key in hex format. */ static get pubkey(): string { if (!this._pubkey) { this._pubkey = getPublicKey(Conf.seckey); } return this._pubkey; } /** Ditto admin secret key as a Web Crypto key. */ static get cryptoKey(): Promise { return crypto.subtle.importKey( 'raw', Conf.seckey, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign', 'verify'], ); } static get port(): number { return parseInt(Deno.env.get('PORT') || '4036'); } static get relay(): `wss://${string}` | `ws://${string}` { const { protocol, host } = Conf.url; return `${protocol === 'https:' ? 'wss:' : 'ws:'}//${host}/relay`; } /** Relay to use for NIP-50 `search` queries. */ static get searchRelay(): string | undefined { return Deno.env.get('SEARCH_RELAY'); } /** Origin of the Ditto server, including the protocol and port. */ static get localDomain(): string { return Deno.env.get('LOCAL_DOMAIN') || `http://localhost:${Conf.port}`; } /** Link to an external nostr viewer. */ static get externalDomain(): string { return Deno.env.get('NOSTR_EXTERNAL') || 'https://njump.me'; } /** Get a link to a nip19-encoded entity in the configured external viewer. */ static external(path: string) { return new URL(path, Conf.externalDomain).toString(); } /** * Heroku-style database URL. This is used in production to connect to the * database. * * Follows the format: * * ```txt * protocol://username:password@host:port/database_name * ``` */ static get databaseUrl(): string { return Deno.env.get('DATABASE_URL') ?? 'file://data/pgdata'; } /** Database to use in tests. */ static get testDatabaseUrl(): string { return Deno.env.get('TEST_DATABASE_URL') ?? 'memory://'; } static db = { /** Database query timeout configurations. */ timeouts: { /** Default query timeout when another setting isn't more specific. */ get default(): number { return Number(Deno.env.get('DB_TIMEOUT_DEFAULT') || 5_000); }, /** Timeout used for queries made through the Nostr relay. */ get relay(): number { return Number(Deno.env.get('DB_TIMEOUT_RELAY') || 1_000); }, /** Timeout used for timelines such as home, notifications, hashtag, etc. */ get timelines(): number { return Number(Deno.env.get('DB_TIMEOUT_TIMELINES') || 15_000); }, }, }; /** Character limit to enforce for posts made through Mastodon API. */ static get postCharLimit(): number { return Number(Deno.env.get('POST_CHAR_LIMIT') || 5000); } /** S3 media storage configuration. */ static s3 = { get endPoint(): string | undefined { return Deno.env.get('S3_ENDPOINT'); }, get region(): string | undefined { return Deno.env.get('S3_REGION'); }, get accessKey(): string | undefined { return Deno.env.get('S3_ACCESS_KEY'); }, get secretKey(): string | undefined { return Deno.env.get('S3_SECRET_KEY'); }, get bucket(): string | undefined { return Deno.env.get('S3_BUCKET'); }, get pathStyle(): boolean | undefined { return optionalBooleanSchema.parse(Deno.env.get('S3_PATH_STYLE')); }, get port(): number | undefined { return optionalNumberSchema.parse(Deno.env.get('S3_PORT')); }, get sessionToken(): string | undefined { return Deno.env.get('S3_SESSION_TOKEN'); }, get useSSL(): boolean | undefined { return optionalBooleanSchema.parse(Deno.env.get('S3_USE_SSL')); }, }; /** IPFS uploader configuration. */ static ipfs = { /** Base URL for private IPFS API calls. */ get apiUrl(): string { return Deno.env.get('IPFS_API_URL') || 'http://localhost:5001'; }, }; /** nostr.build API endpoint when the `nostrbuild` uploader is used. */ static get nostrbuildEndpoint(): string { return Deno.env.get('NOSTRBUILD_ENDPOINT') || 'https://nostr.build/api/v2/upload/files'; } /** Default Blossom servers to use when the `blossom` uploader is set. */ static get blossomServers(): string[] { return Deno.env.get('BLOSSOM_SERVERS')?.split(',') || ['https://blossom.primal.net/']; } /** Module to upload files with. */ static get uploader(): string | undefined { return Deno.env.get('DITTO_UPLOADER'); } /** Location to use for local uploads. */ static get uploadsDir(): string { return Deno.env.get('UPLOADS_DIR') || 'data/uploads'; } /** Media base URL for uploads. */ static get mediaDomain(): string { const value = Deno.env.get('MEDIA_DOMAIN'); if (!value) { const url = Conf.url; url.host = `media.${url.host}`; return url.toString(); } return value; } /** Max upload size for files in number of bytes. Default 100MiB. */ static get maxUploadSize(): number { return Number(Deno.env.get('MAX_UPLOAD_SIZE') || 100 * 1024 * 1024); } /** Usernames that regular users cannot sign up with. */ static get forbiddenUsernames(): string[] { return Deno.env.get('FORBIDDEN_USERNAMES')?.split(',') || [ '_', 'admin', 'administrator', 'root', 'sysadmin', 'system', ]; } /** Proof-of-work configuration. */ static pow = { get registrations(): number { return Number(Deno.env.get('DITTO_POW_REGISTRATIONS') ?? 20); }, }; /** Domain of the Ditto server as a `URL` object, for easily grabbing the `hostname`, etc. */ static get url(): URL { return new URL(Conf.localDomain); } /** Merges the path with the localDomain. */ static local(path: string): string { return mergePaths(Conf.localDomain, path); } /** URL to send Sentry errors to. */ static get sentryDsn(): string | undefined { return Deno.env.get('SENTRY_DSN'); } /** Postgres settings. */ static pg = { /** Number of connections to use in the pool. */ get poolSize(): number { return Number(Deno.env.get('PG_POOL_SIZE') ?? 20); }, }; /** Whether to enable requesting events from known relays. */ static get firehoseEnabled(): boolean { return optionalBooleanSchema.parse(Deno.env.get('FIREHOSE_ENABLED')) ?? true; } /** Number of events the firehose is allowed to process at one time before they have to wait in a queue. */ static get firehoseConcurrency(): number { return Math.ceil(Number(Deno.env.get('FIREHOSE_CONCURRENCY') ?? (Conf.pg.poolSize * 0.25))); } /** Whether to enable Ditto cron jobs. */ static get cronEnabled(): boolean { return optionalBooleanSchema.parse(Deno.env.get('CRON_ENABLED')) ?? true; } /** Crawler User-Agent regex to render link previews to. */ static get crawlerRegex(): RegExp { return new RegExp( Deno.env.get('CRAWLER_REGEX') || 'googlebot|bingbot|yandex|baiduspider|twitterbot|facebookexternalhit|rogerbot|linkedinbot|embedly|quora link preview|showyoubot|outbrain|pinterestbot|slackbot|vkShare|W3C_Validator|whatsapp|mastodon|pleroma|Discordbot|AhrefsBot|SEMrushBot|MJ12bot|SeekportBot|Synapse|Matrix', 'i', ); } /** User-Agent to use when fetching link previews. Pretend to be Facebook by default. */ static get fetchUserAgent(): string { return Deno.env.get('DITTO_FETCH_USER_AGENT') ?? 'facebookexternalhit'; } /** Path to the custom policy module. Must be an absolute path, https:, npm:, or jsr: URI. */ static get policy(): string { return Deno.env.get('DITTO_POLICY') || new URL('../data/policy.ts', import.meta.url).pathname; } /** Whether zap splits should be enabled. */ static get zapSplitsEnabled(): boolean { return optionalBooleanSchema.parse(Deno.env.get('ZAP_SPLITS_ENABLED')) ?? false; } } const optionalBooleanSchema = z .enum(['true', 'false']) .optional() .transform((value) => value !== undefined ? value === 'true' : undefined); const optionalNumberSchema = z .string() .optional() .transform((value) => value !== undefined ? Number(value) : undefined); function mergePaths(base: string, path: string) { const url = new URL( path.startsWith('/') ? path : new URL(path).pathname, base, ); if (!path.startsWith('/')) { // Copy query parameters from the original URL to the new URL const originalUrl = new URL(path); url.search = originalUrl.search; } return url.toString(); } export { Conf };