@geekapps/post-nextjs 0.1.1

package/src/types.ts

@@ -0,0 +1,418 @@
+// ─── Enums ────────────────────────────────────────────────────────────────────
+
+export type MessageType = "email" | "sms" | "whatsapp";
+
+export type MessageStatus =
+  | "queued"
+  | "sent"
+  | "delivered"
+  | "failed"
+  | "bounced"
+  | "opened"
+  | "clicked";
+
+export type DomainType = "sending" | "tracking";
+
+export type DomainStatus = "pending" | "verified" | "failed";
+
+export type PlanTier = "free" | "starter" | "pro" | "enterprise";
+
+export type WhatsappTemplateCategory = "MARKETING" | "UTILITY" | "AUTHENTICATION";
+
+export type WhatsappTemplateStatus =
+  | "APPROVED"
+  | "PENDING"
+  | "REJECTED"
+  | "DISABLED"
+  | "PAUSED";
+
+export type WebhookEvent =
+  | "message_sent"
+  | "message_delivered"
+  | "message_failed"
+  | "message_bounced"
+  | "message_opened"
+  | "message_clicked";
+
+export type WabaStatus = "active" | "token_expired" | "disconnected";
+
+export type WhatsappNumberStatus =
+  | "pending_verification"
+  | "active"
+  | "inactive"
+  | "failed";
+
+export type ManagedNumberStatus =
+  | "provisioning"
+  | "active"
+  | "waiting_whatsapp_verification"
+  | "whatsapp_active"
+  | "suspended"
+  | "canceled"
+  | "failed";
+
+// ─── Core models ──────────────────────────────────────────────────────────────
+
+export interface MessageTemplate {
+  id: string;
+  orgId: string;
+  name: string;
+  type: MessageType;
+  subject: string | null;
+  body: string;
+  variables: string[];
+  description: string | null;
+  isActive: boolean;
+  draftBody: string | null;
+  draftSubject: string | null;
+  draftName: string | null;
+  draftBlocks: unknown[] | null;
+  draftUpdatedAt: string | null;
+  metaTemplateId: string | null;
+  metaStatus: string | null;
+  metaWabaId: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface WhatsappTemplate {
+  id: string;
+  name: string;
+  templateName: string;
+  category: WhatsappTemplateCategory;
+  language: string;
+  header: string | null;
+  footer: string | null;
+  body: string;
+  variables: string[];
+  isActive: boolean;
+  metaTemplateId: string | null;
+  metaStatus: string | null;
+  metaWabaId: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface MessageLog {
+  id: string;
+  type: MessageType;
+  status: MessageStatus;
+  from: string | null;
+  to: string;
+  subject: string | null;
+  templateId: string | null;
+  provider: string | null;
+  externalId: string | null;
+  error: string | null;
+  sentAt: string | null;
+  deliveredAt: string | null;
+  openedAt: string | null;
+  clickedAt: string | null;
+  createdAt: string;
+}
+
+export interface MessageLogDetail extends MessageLog {
+  body: string;
+  variables: Array<{ name: string; value: string }> | null;
+  template: MessageTemplate | null;
+}
+
+export interface OrgDomain {
+  id: string;
+  domain: string;
+  type: DomainType;
+  status: DomainStatus;
+  dkimSelector: string | null;
+  dkimPublicKey: string | null;
+  spfRecord: string | null;
+  trackingCname: string | null;
+  verifiedAt: string | null;
+  createdAt: string;
+}
+
+export interface DnsRecord {
+  type: "TXT" | "CNAME";
+  name: string;
+  value: string | null | undefined;
+}
+
+export interface OrgWebhook {
+  id: string;
+  url: string;
+  events: WebhookEvent[];
+  isActive: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface OrgWebhookWithSecret extends OrgWebhook {
+  secret: string;
+}
+
+export interface WebhookDelivery {
+  id: string;
+  webhookId: string;
+  event: string;
+  statusCode: number | null;
+  response: string | null;
+  success: boolean;
+  createdAt: string;
+}
+
+export interface SmtpConfig {
+  id: string;
+  host: string;
+  port: number;
+  secure: boolean;
+  user: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface OrgPlan {
+  tier: PlanTier;
+  monthlyEmails: number;
+  monthlySms: number;
+  monthlyWhatsapp: number;
+}
+
+export interface OrgUsage {
+  email: number;
+  sms: number;
+  whatsapp: number;
+  period: string;
+}
+
+export interface OrgWaba {
+  id: string;
+  orgId: string;
+  wabaId: string;
+  tokenExpiresAt: string | null;
+  businessName: string | null;
+  status: WabaStatus;
+  connectedAt: string;
+  updatedAt: string;
+}
+
+export interface WhatsappNumberProfile {
+  about: string | null;
+  description: string | null;
+  email: string | null;
+  websites: string[];
+  vertical: string | null;
+  profilePictureUrl: string | null;
+}
+
+export interface WhatsappNumber {
+  id: string;
+  orgId: string;
+  orgWabaId: string;
+  displayName: string;
+  phoneNumber: string;
+  phoneNumberId: string;
+  mode: string;
+  status: WhatsappNumberStatus;
+  qualityRating: string | null;
+  nameStatus: string | null;
+  profile: WhatsappNumberProfile;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ManagedNumber {
+  id: string;
+  orgId: string;
+  phoneNumber: string;
+  areaCode: string;
+  status: ManagedNumberStatus;
+  salvyId: string | null;
+  metaPhoneNumberId: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface AreaCode {
+  areaCode: string;
+  state: string;
+  available: boolean;
+}
+
+// ─── Request types ────────────────────────────────────────────────────────────
+
+export interface SendMessageInput {
+  type: MessageType;
+  to: string;
+  from?: string;
+  title?: string;
+  preview?: string;
+  template?: string;
+  subject?: string;
+  body?: string;
+  variables?: Array<{ name: string; value: string }>;
+}
+
+export interface CreateTemplateInput {
+  name: string;
+  type: MessageType;
+  subject?: string;
+  body: string;
+  description?: string;
+  isActive?: boolean;
+}
+
+export interface UpdateTemplateInput extends Partial<CreateTemplateInput> {}
+
+export interface SaveDraftInput {
+  draftBody: string;
+  draftSubject?: string;
+  draftName?: string;
+  draftBlocks?: unknown[];
+}
+
+export interface CreateWhatsappTemplateInput {
+  name: string;
+  templateName: string;
+  category: WhatsappTemplateCategory;
+  language: string;
+  body: string;
+  header?: string;
+  footer?: string;
+  description?: string;
+}
+
+export interface UpdateWhatsappTemplateInput
+  extends Partial<CreateWhatsappTemplateInput> {}
+
+export interface CreateDomainInput {
+  domain: string;
+  type: DomainType;
+}
+
+export interface CreateWebhookInput {
+  url: string;
+  events: WebhookEvent[];
+  isActive?: boolean;
+}
+
+export interface UpdateWebhookInput extends Partial<CreateWebhookInput> {}
+
+export interface UpsertSmtpConfigInput {
+  host: string;
+  port: number;
+  secure?: boolean;
+  user: string;
+  password: string;
+}
+
+export interface UpdatePlanInput {
+  tier?: PlanTier;
+  monthlyEmails?: number;
+  monthlySms?: number;
+  monthlyWhatsapp?: number;
+}
+
+export interface ListHistoryParams {
+  type?: MessageType;
+  status?: MessageStatus;
+  from?: string;
+  to?: string;
+  page?: number;
+  limit?: number;
+}
+
+export interface StatisticsParams {
+  from?: string;
+  to?: string;
+  groupBy?: "day" | "month";
+}
+
+export interface ConnectWabaInput {
+  code: string;
+}
+
+export interface ConnectWhatsappNumberInput {
+  phoneNumberId: string;
+  wabaId: string;
+}
+
+export interface RegisterWhatsappNumberInput {
+  displayName: string;
+  phoneNumber: string;
+  method?: "SMS" | "VOICE";
+  wabaId?: string;
+}
+
+export interface UpdateWhatsappProfileInput {
+  about?: string;
+  description?: string;
+  email?: string;
+  websites?: string[];
+  vertical?: string;
+}
+
+export interface ProvisionManagedNumberInput {
+  areaCode: string;
+}
+
+// ─── Response types ───────────────────────────────────────────────────────────
+
+export interface SendMessageResult {
+  id: string;
+  status: MessageStatus;
+}
+
+export interface PaginatedResult<T> {
+  data: T[];
+  pagination: {
+    total: number;
+    page: number;
+    limit: number;
+    pages: number;
+  };
+}
+
+export interface StatisticsResult {
+  totals: Record<
+    string,
+    { sent: number; delivered: number; failed: number; opened: number; clicked: number }
+  >;
+  currentPeriod: {
+    period: string;
+    usage: { email: number; sms: number; whatsapp: number };
+    limits: { email: number; sms: number; whatsapp: number };
+  };
+}
+
+export interface PlansResult {
+  plan: OrgPlan;
+  usage: OrgUsage;
+}
+
+export interface AvailablePlan extends OrgPlan {
+  tier: PlanTier;
+}
+
+export interface CreateDomainResult {
+  id: string;
+  domain: string;
+  type: DomainType;
+  status: DomainStatus;
+  dnsRecords: DnsRecord[];
+}
+
+export interface SyncWhatsappTemplatesResult {
+  created: number;
+  skipped: number;
+}
+
+export interface RotateSecretResult {
+  secret: string;
+}
+
+export interface WabaHealthResult {
+  health: unknown;
+}
+
+export interface PhoneNumberStatusResult {
+  status: unknown;
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2020", "DOM"],
+    "types": ["node"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}