commune-ai 0.3.2 → 0.3.5

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AttachmentRecord, AttachmentUrl, AttachmentUploadResponse, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload, ThreadListParams, ThreadListResponse, SearchThreadsParams, SearchThreadResult, ThreadMetadataEntry, DeliveryMetricsParams, DeliveryEventEntry, DeliveryEventsParams, DeliverySuppressionsParams, SuppressionEntry, PhoneNumber, UpdatePhoneNumberPayload, SmsConversation, SmsConversationListParams, SmsMessage, SendSmsPayload, SendSmsResult, SmsSearchParams, CreditBalance, CreditBundle } from './types.js';
+import type { AttachmentRecord, AttachmentUrl, AttachmentUploadResponse, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload, ThreadListParams, ThreadListResponse, SearchThreadsParams, SearchThreadResult, ThreadMetadataEntry, DeliveryMetricsParams, DeliveryEventEntry, DeliveryEventsParams, DeliverySuppressionsParams, SuppressionEntry, PhoneNumber, UpdatePhoneNumberPayload, PhoneNumberWebhookPayload, AvailablePhoneNumber, ProvisionPhoneNumberPayload, SmsConversation, SmsConversationListParams, SmsMessage, SmsListParams, SmsSuppression, SendSmsPayload, SendSmsResult, SmsSearchParams, CreditBalance, CreditBundle, CreditCheckoutResult } from './types.js';
 export type ClientOptions = {
     baseUrl?: string;
     apiKey: string;
@@ -134,15 +134,37 @@ export declare class CommuneClient {
         list: () => Promise<PhoneNumber[]>;
         get: (phoneNumberId: string) => Promise<PhoneNumber>;
         update: (phoneNumberId: string, payload: UpdatePhoneNumberPayload) => Promise<PhoneNumber>;
+        available: (params?: {
+            type?: "TollFree" | "Local";
+            country?: string;
+            area_code?: string;
+            limit?: number;
+        }) => Promise<AvailablePhoneNumber[]>;
+        provision: (payload?: ProvisionPhoneNumberPayload) => Promise<PhoneNumber>;
+        release: (phoneNumberId: string) => Promise<{
+            id: string;
+            status: string;
+            message: string;
+        }>;
+        setAllowList: (phoneNumberId: string, numbers: string[]) => Promise<PhoneNumber>;
+        setBlockList: (phoneNumberId: string, numbers: string[]) => Promise<PhoneNumber>;
+        setWebhook: (phoneNumberId: string, payload: PhoneNumberWebhookPayload) => Promise<PhoneNumber>;
     };
     sms: {
+        list: (params?: SmsListParams) => Promise<SmsMessage[]>;
         send: (payload: SendSmsPayload) => Promise<SendSmsResult>;
         conversations: (params?: SmsConversationListParams) => Promise<SmsConversation[]>;
         thread: (remoteNumber: string, phoneNumberId?: string) => Promise<SmsMessage[]>;
         search: (params: SmsSearchParams) => Promise<SmsMessage[]>;
+        suppressions: (phoneNumberId?: string) => Promise<SmsSuppression[]>;
+        removeSuppression: (phoneNumber: string) => Promise<{
+            removed: boolean;
+            phone_number: string;
+        }>;
     };
     credits: {
         balance: () => Promise<CreditBalance>;
         bundles: () => Promise<CreditBundle[]>;
+        checkout: (bundle: "starter" | "growth" | "scale", returnUrl?: string) => Promise<CreditCheckoutResult>;
     };
 }

package/dist/client.js

@@ -283,8 +283,42 @@ export class CommuneClient {
             update: async (phoneNumberId, payload) => {
                 return this.request(`/v1/phone-numbers/${encodeURIComponent(phoneNumberId)}`, { method: 'PATCH', json: payload });
             },
+            available: async (params) => {
+                return this.request(`/v1/phone-numbers/available${buildQuery({
+                    type: params?.type,
+                    country: params?.country,
+                    area_code: params?.area_code,
+                    limit: params?.limit,
+                })}`);
+            },
+            provision: async (payload) => {
+                return this.request('/v1/phone-numbers', {
+                    method: 'POST',
+                    json: (payload ?? {}),
+                });
+            },
+            release: async (phoneNumberId) => {
+                return this.request(`/v1/phone-numbers/${encodeURIComponent(phoneNumberId)}`, { method: 'DELETE' });
+            },
+            setAllowList: async (phoneNumberId, numbers) => {
+                return this.request(`/v1/phone-numbers/${encodeURIComponent(phoneNumberId)}/allow-list`, { method: 'PUT', json: { numbers } });
+            },
+            setBlockList: async (phoneNumberId, numbers) => {
+                return this.request(`/v1/phone-numbers/${encodeURIComponent(phoneNumberId)}/block-list`, { method: 'PUT', json: { numbers } });
+            },
+            setWebhook: async (phoneNumberId, payload) => {
+                return this.request(`/v1/phone-numbers/${encodeURIComponent(phoneNumberId)}`, { method: 'PATCH', json: { webhook: payload } });
+            },
         };
         this.sms = {
+            list: async (params = {}) => {
+                return this.request(`/v1/sms${buildQuery({
+                    phone_number_id: params.phone_number_id,
+                    limit: params.limit,
+                    before: params.before,
+                    after: params.after,
+                })}`);
+            },
             send: async (payload) => {
                 return this.request('/v1/sms/send', {
                     method: 'POST',
@@ -310,6 +344,12 @@ export class CommuneClient {
                     limit: params.limit,
                 })}`);
             },
+            suppressions: async (phoneNumberId) => {
+                return this.request(`/v1/sms/suppressions${buildQuery({ phone_number_id: phoneNumberId })}`);
+            },
+            removeSuppression: async (phoneNumber) => {
+                return this.request(`/v1/sms/suppressions/${encodeURIComponent(phoneNumber)}`, { method: 'DELETE' });
+            },
         };
         this.credits = {
             balance: async () => {
@@ -318,6 +358,15 @@ export class CommuneClient {
             bundles: async () => {
                 return this.request('/v1/credits/bundles');
             },
+            checkout: async (bundle, returnUrl) => {
+                return this.request('/v1/credits/checkout', {
+                    method: 'POST',
+                    json: {
+                        bundle,
+                        ...(returnUrl ? { success_url: returnUrl, cancel_url: returnUrl } : {}),
+                    },
+                });
+            },
         };
         this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
         this.apiKey = options.apiKey;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CommuneClient } from './client.js';
-export type { ApiError, ApiResponse, AttachmentRecord, Channel, ConversationListParams, CreateDomainPayload, CreateInboxPayload, Direction, DomainEntry, DomainWebhook, InboxEntry, InboxWebhook, InboundEmailWebhookPayload, MessageListParams, MessageMetadata, Participant, ParticipantRole, SendMessagePayload, SearchThreadResult, SearchThreadsParams, ThreadMetadataEntry, SvixHeaders, SuppressionEntry, Thread, DeliveryEventEntry, DeliveryEventsParams, DeliveryMetricsParams, DeliverySuppressionsParams, ThreadListParams, ThreadListResponse, UnifiedMessage, PhoneNumber, UpdatePhoneNumberPayload, SmsConversation, SmsConversationListParams, SmsMessage, SendSmsPayload, SendSmsResult, SmsSearchParams, CreditBalance, CreditBundle, } from './types.js';
+export type { ApiError, ApiResponse, AttachmentRecord, Channel, ConversationListParams, CreateDomainPayload, CreateInboxPayload, Direction, DomainEntry, DomainWebhook, InboxEntry, InboxWebhook, InboundEmailWebhookPayload, MessageListParams, MessageMetadata, Participant, ParticipantRole, SendMessagePayload, SearchThreadResult, SearchThreadsParams, ThreadMetadataEntry, SvixHeaders, SuppressionEntry, Thread, DeliveryEventEntry, DeliveryEventsParams, DeliveryMetricsParams, DeliverySuppressionsParams, ThreadListParams, ThreadListResponse, UnifiedMessage, PhoneNumber, UpdatePhoneNumberPayload, PhoneNumberWebhookPayload, AvailablePhoneNumber, ProvisionPhoneNumberPayload, SmsConversation, SmsConversationListParams, SmsMessage, SmsListParams, SmsSuppression, SendSmsPayload, SendSmsResult, SmsSearchParams, CreditBalance, CreditBundle, CreditCheckoutResult, } from './types.js';
 export { verifyResendWebhook, verifyCommuneWebhook, computeCommuneSignature } from './webhooks.js';
 export type { CommuneWebhookHeaders } from './webhooks.js';
 export { createWebhookHandler } from './listener.js';

package/dist/types.d.ts

@@ -367,6 +367,25 @@ export interface DeliverySuppressionsParams {
     domainId?: string;
     limit?: number;
 }
+export interface AvailablePhoneNumber {
+    phoneNumber: string;
+    friendlyName: string;
+    capabilities: {
+        sms: boolean;
+        mms: boolean;
+        voice: boolean;
+    };
+    region?: string;
+    locality?: string;
+    postalCode?: string;
+}
+export interface ProvisionPhoneNumberPayload {
+    phone_number?: string;
+    type?: 'tollfree' | 'local';
+    country?: string;
+    friendly_name?: string;
+    area_code?: string;
+}
 export interface PhoneNumber {
     id: string;
     number: string;
@@ -386,11 +405,17 @@ export interface PhoneNumber {
     createdAt: string;
     updatedAt: string;
 }
+export interface PhoneNumberWebhookPayload {
+    endpoint?: string;
+    secret?: string;
+    events?: string[];
+}
 export interface UpdatePhoneNumberPayload {
     friendlyName?: string;
     autoReply?: string | null;
     allowList?: string[];
     blockList?: string[];
+    webhook?: PhoneNumberWebhookPayload;
 }
 export interface SmsConversation {
     thread_id: string;
@@ -443,6 +468,19 @@ export interface SmsSearchParams {
     phone_number_id?: string;
     limit?: number;
 }
+export interface SmsListParams {
+    phone_number_id?: string;
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+export interface SmsSuppression {
+    phone_number: string;
+    orgId: string;
+    phone_number_id?: string;
+    reason?: string;
+    created_at?: string;
+}
 export interface CreditBalance {
     included: number;
     purchased: number;
@@ -453,6 +491,12 @@ export interface CreditBundle {
     id: string;
     credits: number;
     price: number;
-    pricePerCredit: string;
-    available: boolean;
+    price_per_credit: string;
+    available?: boolean;
+}
+export interface CreditCheckoutResult {
+    checkout_url: string;
+    bundle: string;
+    credits: number;
+    price: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commune-ai",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "description": "Email infrastructure for agents — set up an inbox and send your first email in 30 seconds. Programmatic inboxes (~1 line), consistent threads, custom domains, attachments, and structured data.",
   "type": "module",
   "main": "dist/index.js",