@jant/core 0.5.4 → 0.6.1

package/src/db/migrations/pg/meta/_journal.json

@@ -141,6 +141,34 @@
       "when": 1777545080191,
       "tag": "0019_gray_natasha_romanoff",
       "breakpoints": true
+    },
+    {
+      "idx": 20,
+      "version": "7",
+      "when": 1778796689691,
+      "tag": "0020_bizarre_smasher",
+      "breakpoints": true
+    },
+    {
+      "idx": 21,
+      "version": "7",
+      "when": 1778971491254,
+      "tag": "0021_sharp_puppet_master",
+      "breakpoints": true
+    },
+    {
+      "idx": 22,
+      "version": "7",
+      "when": 1779056638164,
+      "tag": "0022_blushing_blue_shield",
+      "breakpoints": true
+    },
+    {
+      "idx": 23,
+      "version": "7",
+      "when": 1779059130438,
+      "tag": "0023_organic_zemo",
+      "breakpoints": true
     }
   ]
 }

package/src/db/pg/schema.ts

@@ -825,6 +825,88 @@ export const githubAppInstallation = pgTable(
   ],
 );
 
+// ---------------------------------------------------------------------------
+// Telegram bindings (connect a Telegram account to post Notes via a bot)
+// ---------------------------------------------------------------------------
+
+export const telegramPendingBindings = pgTable(
+  "telegram_pending_binding",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    code: text("code").notNull(),
+    createdAt: integer("created_at").notNull(),
+    expiresAt: integer("expires_at").notNull(),
+  },
+  (table) => [
+    uniqueIndex("uq_telegram_pending_binding_site_id").on(table.siteId),
+    uniqueIndex("uq_telegram_pending_binding_code").on(table.code),
+  ],
+);
+
+export const telegramBindings = pgTable(
+  "telegram_binding",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    botId: text("bot_id").notNull(),
+    telegramUserId: text("telegram_user_id").notNull(),
+    telegramUsername: text("telegram_username"),
+    lastUpdateId: integer("last_update_id"),
+    boundAt: integer("bound_at").notNull(),
+  },
+  (table) => [
+    uniqueIndex("uq_telegram_binding_site_id").on(table.siteId),
+    uniqueIndex("uq_telegram_binding_bot_user").on(
+      table.botId,
+      table.telegramUserId,
+    ),
+  ],
+);
+
+/** Mirror of `telegram_media_group_item` in the SQLite schema. */
+export const telegramMediaGroupItems = pgTable(
+  "telegram_media_group_item",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    botId: text("bot_id").notNull(),
+    telegramUserId: text("telegram_user_id").notNull(),
+    mediaGroupId: text("media_group_id").notNull(),
+    chatId: integer("chat_id").notNull(),
+    messageId: integer("message_id").notNull(),
+    updateId: integer("update_id").notNull(),
+    fileId: text("file_id").notNull(),
+    mediaKind: text("media_kind").notNull(),
+    mimeType: text("mime_type"),
+    originalName: text("original_name"),
+    captionMarkdown: text("caption_markdown"),
+    width: integer("width"),
+    height: integer("height"),
+    durationSeconds: integer("duration_seconds"),
+    /** Telegram `thumbnail.file_id` for videos / previewable documents. */
+    posterFileId: text("poster_file_id"),
+    createdAt: integer("created_at").notNull(),
+  },
+  (table) => [
+    index("idx_telegram_media_group_item_group").on(
+      table.botId,
+      table.mediaGroupId,
+    ),
+    uniqueIndex("uq_telegram_media_group_item_message").on(
+      table.botId,
+      table.mediaGroupId,
+      table.messageId,
+    ),
+  ],
+);
+
 // ---------------------------------------------------------------------------
 // Rate Limit
 // ---------------------------------------------------------------------------

package/src/db/schema.ts

@@ -775,6 +775,96 @@ export const githubAppInstallation = sqliteTable(
   ],
 );
 
+// ---------------------------------------------------------------------------
+// Telegram bindings (connect a Telegram account to post Notes via a bot)
+// ---------------------------------------------------------------------------
+
+export const telegramPendingBindings = sqliteTable(
+  "telegram_pending_binding",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    code: text("code").notNull(),
+    createdAt: integer("created_at").notNull(),
+    expiresAt: integer("expires_at").notNull(),
+  },
+  (table) => [
+    uniqueIndex("uq_telegram_pending_binding_site_id").on(table.siteId),
+    uniqueIndex("uq_telegram_pending_binding_code").on(table.code),
+  ],
+);
+
+export const telegramBindings = sqliteTable(
+  "telegram_binding",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    botId: text("bot_id").notNull(),
+    telegramUserId: text("telegram_user_id").notNull(),
+    telegramUsername: text("telegram_username"),
+    lastUpdateId: integer("last_update_id"),
+    boundAt: integer("bound_at").notNull(),
+  },
+  (table) => [
+    uniqueIndex("uq_telegram_binding_site_id").on(table.siteId),
+    uniqueIndex("uq_telegram_binding_bot_user").on(
+      table.botId,
+      table.telegramUserId,
+    ),
+  ],
+);
+
+/**
+ * Short-lived buffer for Telegram album (media_group_id) messages.
+ *
+ * Telegram splits an album into one webhook update per item, sharing a
+ * `media_group_id`. The webhook handler inserts one row per item, sleeps a
+ * short window for the rest of the group to arrive, then atomically claims
+ * the whole group with `DELETE ... RETURNING` to publish a single post with
+ * all attachments. Rows are deleted on flush, so the table stays small.
+ */
+export const telegramMediaGroupItems = sqliteTable(
+  "telegram_media_group_item",
+  {
+    id: text("id").primaryKey(),
+    siteId: text("site_id")
+      .notNull()
+      .references(() => sites.id, { onDelete: "cascade" }),
+    botId: text("bot_id").notNull(),
+    telegramUserId: text("telegram_user_id").notNull(),
+    mediaGroupId: text("media_group_id").notNull(),
+    chatId: integer("chat_id").notNull(),
+    messageId: integer("message_id").notNull(),
+    updateId: integer("update_id").notNull(),
+    fileId: text("file_id").notNull(),
+    mediaKind: text("media_kind").notNull(),
+    mimeType: text("mime_type"),
+    originalName: text("original_name"),
+    captionMarkdown: text("caption_markdown"),
+    width: integer("width"),
+    height: integer("height"),
+    durationSeconds: integer("duration_seconds"),
+    /** Telegram `thumbnail.file_id` for videos / previewable documents. */
+    posterFileId: text("poster_file_id"),
+    createdAt: integer("created_at").notNull(),
+  },
+  (table) => [
+    index("idx_telegram_media_group_item_group").on(
+      table.botId,
+      table.mediaGroupId,
+    ),
+    uniqueIndex("uq_telegram_media_group_item_message").on(
+      table.botId,
+      table.mediaGroupId,
+      table.messageId,
+    ),
+  ],
+);
+
 // =============================================================================
 // Rate Limit
 // =============================================================================

package/src/i18n/coverage.generated.ts

@@ -12,6 +12,6 @@ import type { Locale } from "./locales.js";
 
 export const SETTINGS_TRANSLATION_COVERAGE: Record<Locale, number> = {
   en: 1,
-  "zh-Hans": 1,
-  "zh-Hant": 1,
+  "zh-Hans": 0.9254658385093167,
+  "zh-Hant": 0.9254658385093167,
 } as const;

package/src/i18n/locales/public/en.po

@@ -1773,13 +1773,21 @@ msgstr "Settings"
 msgid "Shared links"
 msgstr "Shared links"
 
+#. @context: Collapse expanded thread ancestor context in the feed
+#. @context: Collapse expanded thread ancestor context in the feed
 #. @context: Collapse reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show less"
 msgstr "Show less"
 
+#. @context: Expand faded thread ancestor context in the feed
+#. @context: Expand faded thread ancestor context in the feed
 #. @context: Expand reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show more"
 msgstr "Show more"
 

package/src/i18n/locales/public/zh-Hans.po

@@ -1770,13 +1770,21 @@ msgstr ""
 msgid "Shared links"
 msgstr ""
 
+#. @context: Collapse expanded thread ancestor context in the feed
+#. @context: Collapse expanded thread ancestor context in the feed
 #. @context: Collapse reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show less"
 msgstr ""
 
+#. @context: Expand faded thread ancestor context in the feed
+#. @context: Expand faded thread ancestor context in the feed
 #. @context: Expand reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show more"
 msgstr ""
 

package/src/i18n/locales/public/zh-Hant.po

@@ -1770,13 +1770,21 @@ msgstr ""
 msgid "Shared links"
 msgstr ""
 
+#. @context: Collapse expanded thread ancestor context in the feed
+#. @context: Collapse expanded thread ancestor context in the feed
 #. @context: Collapse reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show less"
 msgstr ""
 
+#. @context: Expand faded thread ancestor context in the feed
+#. @context: Expand faded thread ancestor context in the feed
 #. @context: Expand reply context
 #: src/ui/compose/ComposeDialog.tsx
+#: src/ui/feed/ThreadPreview.tsx
+#: src/ui/pages/PostPage.tsx
 msgid "Show more"
 msgstr ""
 

package/src/i18n/locales/settings/en.po

@@ -221,6 +221,11 @@ msgstr "Before deleting, download a site export. You won't be able to recover th
 msgid "Blog Avatar"
 msgstr "Blog Avatar"
 
+#. @context: Label for the Telegram bot token input
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Bot token"
+msgstr "Bot token"
+
 #. @context: Section heading for built-in nav items
 #: src/ui/dash/appearance/NavigationContent.tsx
 msgid "Built-in links"
@@ -234,6 +239,8 @@ msgstr "Built-in links"
 #. @context: Button label to dismiss a dialog or action
 #. @context: Button label to dismiss a dialog or action
 #. @context: Button label to dismiss a dialog or action
+#. @context: Button label to dismiss a dialog or action
+#. @context: Button label to dismiss a dialog or action
 #. @context: Button to cancel form
 #. @context: Button to cancel settings changes
 #. @context: Button to cancel unsaved changes and revert to original values
@@ -250,6 +257,8 @@ msgstr "Built-in links"
 #: src/ui/dash/settings/GeneralContent.tsx
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 #: src/ui/dash/settings/SessionsContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
 msgid "Cancel"
 msgstr "Cancel"
 
@@ -343,11 +352,31 @@ msgstr "Connect"
 msgid "Connect a GitHub repository to automatically back up your posts as Markdown files. Edits on GitHub sync back to your site."
 msgstr "Connect a GitHub repository to automatically back up your posts as Markdown files. Edits on GitHub sync back to your site."
 
+#. @context: Intro text on the Telegram settings page when no bot is set up
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Connect a Telegram bot, then anything you message it gets published as a note."
+msgstr "Connect a Telegram bot, then anything you message it gets published as a note."
+
+#. @context: Toggle that reveals manual Telegram binding instructions when the deep link can't be used
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Connect manually"
+msgstr "Connect manually"
+
+#. @context: Heading on the Telegram settings page when ready to connect
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Connect Telegram"
+msgstr "Connect Telegram"
+
 #. @context: Heading for the GitHub App connect option on GitHub Sync setup
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 msgid "Connect with GitHub App"
 msgstr "Connect with GitHub App"
 
+#. @context: Status label when Telegram is connected, with the account name
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Connected as {account}"
+msgstr "Connected as {account}"
+
 #. @context: Status label when GitHub Sync is active using the GitHub App
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 msgid "Connected via GitHub App"
@@ -369,12 +398,20 @@ msgid "Connecting…"
 msgstr "Connecting…"
 
 #. @context: Feedback after copying API token
+#. @context: Feedback after copying to clipboard
 #: src/ui/dash/settings/ApiTokensContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
 msgid "Copied"
 msgstr "Copied"
 
 #. @context: Button to copy a URL to the clipboard
+#. @context: Button to copy the Telegram binding code
+#. @context: Button to copy the Telegram binding code
+#. @context: Button to copy the Telegram binding code
 #: src/ui/dash/settings/GeneralContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
 msgid "Copy"
 msgstr "Copy"
 
@@ -410,6 +447,11 @@ msgstr "Couldn't delete. Try again in a moment."
 msgid "Couldn't save. Try again in a moment."
 msgstr "Couldn't save. Try again in a moment."
 
+#. @context: Help text explaining where to get a Telegram bot token
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Create a bot by messaging @BotFather on Telegram, then paste the token it gives you."
+msgstr "Create a bot by messaging @BotFather on Telegram, then paste the token it gives you."
+
 #. @context: Link text pointing to GitHub's new repository page
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 msgid "Create a new repository"
@@ -571,9 +613,11 @@ msgid "Destination"
 msgstr "Destination"
 
 #. @context: Button to disconnect GitHub repository on GitHub Sync settings
+#. @context: Button to disconnect Telegram
 #. @context: Section heading for disconnect action on GitHub Sync settings
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 #: src/ui/dash/settings/GitHubSyncContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
 msgid "Disconnect"
 msgstr "Disconnect"
 
@@ -582,6 +626,11 @@ msgstr "Disconnect"
 msgid "Disconnect from GitHub? The webhook will be removed. Your repository content will not be deleted."
 msgstr "Disconnect from GitHub? The webhook will be removed. Your repository content will not be deleted."
 
+#. @context: Confirmation message when disconnecting Telegram
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Disconnect Telegram? You can reconnect any time with a new binding code."
+msgstr "Disconnect Telegram? You can reconnect any time with a new binding code."
+
 #. @context: Checkbox to show avatar in the site header
 #: src/ui/dash/settings/AvatarContent.tsx
 msgid "Display avatar in my site header"
@@ -732,6 +781,11 @@ msgstr "General"
 msgid "Generate Token"
 msgstr "Generate Token"
 
+#. @context: Button to regenerate the Telegram binding code
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Get a new code"
+msgstr "Get a new code"
+
 #. @context: Breadcrumb label
 #. @context: Settings item — GitHub sync settings
 #. @context: Settings section heading for GitHub Sync setup
@@ -801,6 +855,11 @@ msgstr "Install GitHub App"
 msgid "Install the GitHub App to grant access without managing personal tokens. Permissions are scoped per repository and revocable from GitHub."
 msgstr "Install the GitHub App to grant access without managing personal tokens. Permissions are scoped per repository and revocable from GitHub."
 
+#. @context: Settings group label for third-party integrations
+#: src/ui/dash/settings/SettingsRootContent.tsx
+msgid "Integrations"
+msgstr "Integrations"
+
 #. @context: Nav item label field
 #: src/ui/dash/appearance/NavigationContent.tsx
 msgid "Label"
@@ -943,6 +1002,11 @@ msgstr "March 14"
 msgid "Markdown supported"
 msgstr "Markdown supported"
 
+#. @context: Hint shown when Telegram is connected
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Message the bot any text and it's published as a note."
+msgstr "Message the bot any text and it's published as a note."
+
 #. @context: Section label for nav items hidden under More dropdown
 #: src/ui/dash/appearance/NavigationContent.tsx
 msgid "More"
@@ -1056,11 +1120,31 @@ msgstr "Not synced yet"
 msgid "Note"
 msgstr "Note"
 
+#. @context: Caption inside the manual Telegram binding fallback. {linkOpen}/{linkClose} wrap the bot username as a t.me link — keep them around the @username token in translations.
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Open {linkOpen}@{botUsername}{linkClose} and send:"
+msgstr "Open {linkOpen}@{botUsername}{linkClose} and send:"
+
+#. @context: Button that opens the Telegram bot via a deep link
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Open Telegram to connect"
+msgstr "Open Telegram to connect"
+
+#. @context: Instructions on the Telegram settings page for connecting an account
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Open the bot and send the binding code, then anything you message it becomes a note."
+msgstr "Open the bot and send the binding code, then anything you message it becomes a note."
+
 #. @context: Settings item description for the hosted delete-site entry in the account menu
 #: src/ui/dash/settings/AccountMenuContent.tsx
 msgid "Open the hosted site controls in {providerLabel} to cancel billing or permanently delete this site."
 msgstr "Open the hosted site controls in {providerLabel} to cancel billing or permanently delete this site."
 
+#. @context: Separator between the QR code and the deep-link button on the Telegram connect page
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "or"
+msgstr "or"
+
 #. @context: GitHub sync picker — placeholder text showing the expected input shape
 #: src/routes/dash/settings.tsx
 msgid "owner/repo"
@@ -1135,6 +1219,11 @@ msgstr "Pinned"
 msgid "Post"
 msgstr "Post"
 
+#. @context: Settings item description for Telegram integration
+#: src/ui/dash/settings/SettingsRootContent.tsx
+msgid "Post notes by messaging a Telegram bot"
+msgstr "Post notes by messaging a Telegram bot"
+
 #. @context: GitHub sync picker — badge next to private repos
 #: src/routes/dash/settings.tsx
 msgid "Private"
@@ -1155,6 +1244,11 @@ msgstr "Published"
 msgid "Push all posts to GitHub right now instead of waiting for the next automatic sync."
 msgstr "Push all posts to GitHub right now instead of waiting for the next automatic sync."
 
+#. @context: Accessible label for the Telegram connect QR code
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "QR code linking to the Telegram bot"
+msgstr "QR code linking to the Telegram bot"
+
 #. @context: Archive custom URL query params field
 #: src/routes/dash/custom-urls.tsx
 msgid "Query Parameters"
@@ -1204,6 +1298,16 @@ msgstr "Refresh repository list"
 msgid "Remove"
 msgstr "Remove"
 
+#. @context: Button to remove the saved Telegram bot token
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Remove bot"
+msgstr "Remove bot"
+
+#. @context: Confirmation message when removing the Telegram bot token
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Remove the saved bot token? Its webhook is deleted and any connected account is disconnected."
+msgstr "Remove the saved bot token? Its webhook is deleted and any connected account is disconnected."
+
 #. @context: Description for disconnect action on GitHub Sync settings
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 msgid "Remove the webhook and stop syncing. Your repository content will not be deleted."
@@ -1261,6 +1365,11 @@ msgstr "Safe to leave this page — syncing continues in the background."
 msgid "Save"
 msgstr "Save"
 
+#. @context: Button to save the Telegram bot token
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Save bot token"
+msgstr "Save bot token"
+
 #. @context: Button to save custom CSS
 #: src/ui/dash/appearance/AdvancedContent.tsx
 msgid "Save CSS"
@@ -1406,6 +1515,11 @@ msgstr "Site-wide HTML for analytics and widgets"
 msgid "Soft color should still carry a clear reading rhythm."
 msgstr "Soft color should still carry a clear reading rhythm."
 
+#. @context: Description for the Telegram disconnect action
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Stop accepting posts from Telegram. Your existing notes stay published."
+msgstr "Stop accepting posts from Telegram. Your existing notes stay published."
+
 #. @context: Button to trigger a full content push to GitHub on GitHub Sync settings
 #: src/ui/dash/settings/GitHubSyncContent.tsx
 msgid "Sync Now"
@@ -1426,6 +1540,22 @@ msgstr "system"
 msgid "Target Slug"
 msgstr "Target Slug"
 
+#. @context: Breadcrumb label
+#. @context: Settings item — Telegram integration settings
+#. @context: Settings section heading for Telegram setup
+#. @context: Settings section heading for Telegram setup
+#: src/routes/dash/settings.tsx
+#: src/ui/dash/settings/SettingsRootContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Telegram"
+msgstr "Telegram"
+
+#. @context: Error shown on the Telegram settings page when the bot can't be reached
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "Telegram is set up, but the bot couldn't be reached. Check the bot token and try again."
+msgstr "Telegram is set up, but the bot couldn't be reached. Check the bot token and try again."
+
 #. @context: Error toast when selected font theme is not valid
 #: src/routes/dash/settings.tsx
 msgid "That font theme isn't available. Pick another one."
@@ -1635,3 +1765,8 @@ msgstr "We'll prefill the name {name}. The list refreshes on return."
 #: src/ui/dash/settings/AccountMenuContent.tsx
 msgid "When to use site export, database backups, and recovery drills."
 msgstr "When to use site export, database backups, and recovery drills."
+
+#. @context: Fallback name when a connected Telegram account has no username
+#: src/ui/dash/settings/TelegramContent.tsx
+msgid "your Telegram account"
+msgstr "your Telegram account"