@prajwalshete/telegram-plugin 0.0.0-stage → 0.1.0

package/dist/schema/index.js

@@ -0,0 +1,44 @@
+import { SCHEMA_VERSION } from "./version.js";
+import { telegramTables } from "./tables.js";
+import { referenceSql, referenceSqlStatements } from "./ddl.js";
+// src/schema/index.ts
+const defaults = telegramTables();
+/** Bots (`tg_bot`): encrypted token and webhook secret, mode, status, pacing and drain lease. */
+const tgBot = defaults.tgBot;
+/** Chats (`tg_chat`): Telegram chats per bot, linked user or group audience, locale, status. */
+const tgChat = defaults.tgChat;
+/** One-time link codes (`tg_link_code`), stored hashed with an expiry. */
+const tgLinkCode = defaults.tgLinkCode;
+/** Named destinations (`tg_destination`): a slug for a chat, optionally `ai_allowed`. */
+const tgDestination = defaults.tgDestination;
+/** Per-bot command configuration (`tg_command`): enabled, roles, aliases, menu. */
+const tgCommand = defaults.tgCommand;
+/** Templates (`tg_template`): message / report bodies per locale, provider, buttons. */
+const tgTemplate = defaults.tgTemplate;
+/** Append-only template history (`tg_template_version`). */
+const tgTemplateVersion = defaults.tgTemplateVersion;
+/** Per-chat subscriptions (`tg_subscription`): mute and quiet hours per topic. */
+const tgSubscription = defaults.tgSubscription;
+/** Recurring schedules (`tg_schedule`): rule, IANA zone, template, recipients, `next_run_at`. */
+const tgSchedule = defaults.tgSchedule;
+/** Schedule run history (`tg_schedule_run`). */
+const tgScheduleRun = defaults.tgScheduleRun;
+/** Event rules (`tg_event_rule`): event key, filters, template, recipients, throttle. */
+const tgEventRule = defaults.tgEventRule;
+/** Emitted host events (`tg_event`), processed by the tick. */
+const tgEvent = defaults.tgEvent;
+/** One-off broadcasts (`tg_broadcast`) and their progress. */
+const tgBroadcast = defaults.tgBroadcast;
+/** The outbox (`tg_delivery`): one row per message part, with status, attempts and dedupe key. */
+const tgDelivery = defaults.tgDelivery;
+/** Received Telegram updates (`tg_update`): dedupe and processing state. */
+const tgUpdate = defaults.tgUpdate;
+/** Callback-button tokens (`tg_action_token`): action, params, expiry, single use. */
+const tgActionToken = defaults.tgActionToken;
+/** Active dialogs (`tg_dialog`): step, state and expiry per chat. */
+const tgDialog = defaults.tgDialog;
+/** Plugin key/value state (`tg_state`): schema version, last tick, throttles. */
+const tgState = defaults.tgState;
+/** Audit rows (`tg_audit`) written with admin changes. */
+const tgAudit = defaults.tgAudit;
+export { SCHEMA_VERSION, referenceSql, referenceSqlStatements, telegramTables, tgActionToken, tgAudit, tgBot, tgBroadcast, tgChat, tgCommand, tgDelivery, tgDestination, tgDialog, tgEvent, tgEventRule, tgLinkCode, tgSchedule, tgScheduleRun, tgState, tgSubscription, tgTemplate, tgTemplateVersion, tgUpdate };

package/dist/schema/reference.sql

@@ -0,0 +1,359 @@
+-- cf-telegram-plugin reference schema. Generated from telegramTables(); do not edit by hand.
+
+CREATE TABLE IF NOT EXISTS tg_bot (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  name TEXT NOT NULL,
+  tg_bot_id TEXT NOT NULL,
+  username TEXT NOT NULL,
+  token_enc TEXT NOT NULL,
+  webhook_secret_enc TEXT,
+  mode TEXT NOT NULL DEFAULT 'webhook',
+  status TEXT NOT NULL DEFAULT 'active',
+  status_detail TEXT,
+  checked_at INTEGER,
+  default_locale TEXT NOT NULL DEFAULT 'en',
+  features_json TEXT,
+  rate_per_sec INTEGER NOT NULL DEFAULT 25,
+  paused_until INTEGER,
+  drain_lease_until INTEGER,
+  drain_token TEXT,
+  commands_synced_hash TEXT,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS tg_bot_tenant_status_idx ON tg_bot (tenant, status);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_bot_tg_bot_uq ON tg_bot (tenant, tg_bot_id) WHERE deleted_at IS NULL;
+
+CREATE TABLE IF NOT EXISTS tg_chat (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  chat_id TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  title TEXT,
+  username TEXT,
+  user_id TEXT,
+  audience_json TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  locale TEXT,
+  timezone TEXT,
+  topics_json TEXT,
+  next_allowed_at INTEGER,
+  minute_window_start INTEGER,
+  minute_count INTEGER NOT NULL DEFAULT 0,
+  linked_by TEXT,
+  linked_at INTEGER,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_chat_bot_chat_uq ON tg_chat (tenant, bot_id, chat_id);
+
+CREATE INDEX IF NOT EXISTS tg_chat_user_idx ON tg_chat (user_id);
+
+CREATE INDEX IF NOT EXISTS tg_chat_bot_status_idx ON tg_chat (bot_id, status);
+
+CREATE TABLE IF NOT EXISTS tg_link_code (
+  code_hash TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  purpose TEXT NOT NULL,
+  user_id TEXT,
+  audience_json TEXT,
+  expires_at INTEGER NOT NULL,
+  used_at INTEGER,
+  used_by_chat TEXT,
+  created_by TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS tg_link_code_expires_idx ON tg_link_code (expires_at);
+
+CREATE TABLE IF NOT EXISTS tg_destination (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  name TEXT NOT NULL,
+  slug TEXT NOT NULL,
+  bot_id TEXT NOT NULL,
+  chat_ref TEXT NOT NULL,
+  message_thread_id INTEGER,
+  ai_allowed INTEGER NOT NULL DEFAULT 0,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_destination_slug_uq ON tg_destination (tenant, slug);
+
+CREATE TABLE IF NOT EXISTS tg_command (
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  command TEXT NOT NULL,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  roles_json TEXT,
+  aliases_json TEXT,
+  description_json TEXT,
+  show_in_menu INTEGER NOT NULL DEFAULT 1,
+  sort INTEGER NOT NULL DEFAULT 0,
+  updated_by TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (tenant, bot_id, command)
+);
+
+CREATE TABLE IF NOT EXISTS tg_template (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  kind TEXT NOT NULL DEFAULT 'message',
+  provider TEXT,
+  provider_params_json TEXT,
+  body_json TEXT NOT NULL,
+  format TEXT NOT NULL DEFAULT 'html',
+  report_json TEXT,
+  buttons_json TEXT,
+  options_json TEXT,
+  version INTEGER NOT NULL DEFAULT 1,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_by TEXT,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_template_key_uq ON tg_template (tenant, key);
+
+CREATE TABLE IF NOT EXISTS tg_template_version (
+  tenant TEXT NOT NULL DEFAULT '',
+  template_id TEXT NOT NULL,
+  version INTEGER NOT NULL,
+  body_json TEXT NOT NULL,
+  report_json TEXT,
+  buttons_json TEXT,
+  saved_by TEXT,
+  saved_at INTEGER NOT NULL,
+  PRIMARY KEY (template_id, version)
+);
+
+CREATE TABLE IF NOT EXISTS tg_subscription (
+  tenant TEXT NOT NULL DEFAULT '',
+  chat_ref TEXT NOT NULL,
+  topic TEXT NOT NULL,
+  muted INTEGER NOT NULL DEFAULT 0,
+  quiet_json TEXT,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (tenant, chat_ref, topic)
+);
+
+CREATE TABLE IF NOT EXISTS tg_schedule (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  name TEXT NOT NULL,
+  rule_json TEXT NOT NULL,
+  timezone TEXT NOT NULL,
+  template_id TEXT NOT NULL,
+  params_json TEXT,
+  recipients_json TEXT NOT NULL,
+  personalize INTEGER NOT NULL DEFAULT 1,
+  missed_policy TEXT NOT NULL DEFAULT 'run_once',
+  missed_grace_min INTEGER NOT NULL DEFAULT 30,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  paused_until INTEGER,
+  next_run_at INTEGER,
+  claim_until INTEGER,
+  claim_token TEXT,
+  last_run_at INTEGER,
+  last_status TEXT,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS tg_schedule_due_idx ON tg_schedule (enabled, next_run_at);
+
+CREATE TABLE IF NOT EXISTS tg_schedule_run (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  schedule_id TEXT NOT NULL,
+  slot_at INTEGER NOT NULL,
+  trigger TEXT NOT NULL DEFAULT 'schedule',
+  started_at INTEGER NOT NULL,
+  finished_at INTEGER,
+  status TEXT NOT NULL DEFAULT 'running',
+  deliveries INTEGER NOT NULL DEFAULT 0,
+  error TEXT,
+  template_version INTEGER
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_schedule_run_slot_uq ON tg_schedule_run (schedule_id, slot_at);
+
+CREATE TABLE IF NOT EXISTS tg_event_rule (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  event TEXT NOT NULL,
+  name TEXT NOT NULL,
+  filter_json TEXT,
+  template_id TEXT NOT NULL,
+  recipients_json TEXT NOT NULL,
+  throttle_json TEXT,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  deleted_at INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS tg_event_rule_event_idx ON tg_event_rule (tenant, event, enabled);
+
+CREATE TABLE IF NOT EXISTS tg_event (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  event TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  dedupe_key TEXT NOT NULL,
+  occurred_at INTEGER NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  attempts INTEGER NOT NULL DEFAULT 0,
+  claim_until INTEGER,
+  claim_token TEXT,
+  processed_at INTEGER,
+  error TEXT
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_event_dedupe_uq ON tg_event (tenant, dedupe_key);
+
+CREATE INDEX IF NOT EXISTS tg_event_status_idx ON tg_event (status, occurred_at);
+
+CREATE TABLE IF NOT EXISTS tg_broadcast (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  title TEXT NOT NULL,
+  template_id TEXT,
+  body_json TEXT,
+  params_json TEXT,
+  file_ref TEXT,
+  recipients_json TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'draft',
+  stats_json TEXT,
+  created_by TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  sent_at INTEGER,
+  deleted_at INTEGER
+);
+
+CREATE TABLE IF NOT EXISTS tg_delivery (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  chat_ref TEXT NOT NULL,
+  message_thread_id INTEGER,
+  source TEXT NOT NULL,
+  source_id TEXT,
+  kind TEXT NOT NULL DEFAULT 'text',
+  body_html TEXT,
+  part INTEGER NOT NULL DEFAULT 0,
+  parts INTEGER NOT NULL DEFAULT 1,
+  file_ref TEXT,
+  file_name TEXT,
+  file_mime TEXT,
+  reply_markup_json TEXT,
+  options_json TEXT,
+  render_json TEXT,
+  target_message_id INTEGER,
+  dedupe_key TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'queued',
+  attempts INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at INTEGER NOT NULL,
+  lease_until INTEGER,
+  lease_token TEXT,
+  tg_message_id INTEGER,
+  error_code TEXT,
+  error_detail TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  sent_at INTEGER
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS tg_delivery_dedupe_uq ON tg_delivery (tenant, dedupe_key);
+
+CREATE INDEX IF NOT EXISTS tg_delivery_due_idx ON tg_delivery (bot_id, status, next_attempt_at);
+
+CREATE INDEX IF NOT EXISTS tg_delivery_source_idx ON tg_delivery (source, source_id);
+
+CREATE TABLE IF NOT EXISTS tg_update (
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  update_id INTEGER NOT NULL,
+  kind TEXT,
+  chat_id TEXT,
+  status TEXT NOT NULL DEFAULT 'received',
+  attempts INTEGER NOT NULL DEFAULT 0,
+  received_at INTEGER NOT NULL,
+  processed_at INTEGER,
+  error TEXT,
+  PRIMARY KEY (bot_id, update_id)
+);
+
+CREATE INDEX IF NOT EXISTS tg_update_status_idx ON tg_update (status, received_at);
+
+CREATE TABLE IF NOT EXISTS tg_action_token (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  bot_id TEXT NOT NULL,
+  action TEXT NOT NULL,
+  params_json TEXT,
+  chat_ref TEXT,
+  user_id TEXT,
+  single_use INTEGER NOT NULL DEFAULT 1,
+  confirmed_at INTEGER,
+  expires_at INTEGER NOT NULL,
+  used_at INTEGER,
+  result TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS tg_action_token_expires_idx ON tg_action_token (expires_at);
+
+CREATE TABLE IF NOT EXISTS tg_dialog (
+  tenant TEXT NOT NULL DEFAULT '',
+  chat_ref TEXT NOT NULL,
+  dialog TEXT NOT NULL,
+  user_id TEXT,
+  step TEXT NOT NULL,
+  state_json TEXT NOT NULL DEFAULT '{}',
+  expires_at INTEGER NOT NULL,
+  started_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (tenant, chat_ref)
+);
+
+CREATE INDEX IF NOT EXISTS tg_dialog_expires_idx ON tg_dialog (expires_at);
+
+CREATE TABLE IF NOT EXISTS tg_state (
+  tenant TEXT NOT NULL DEFAULT '',
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  updated_at INTEGER NOT NULL,
+  PRIMARY KEY (tenant, key)
+);
+
+CREATE TABLE IF NOT EXISTS tg_audit (
+  id TEXT PRIMARY KEY NOT NULL,
+  tenant TEXT NOT NULL DEFAULT '',
+  actor TEXT,
+  entity TEXT NOT NULL,
+  entity_id TEXT,
+  action TEXT NOT NULL,
+  diff_json TEXT,
+  at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS tg_audit_entity_idx ON tg_audit (entity, entity_id);