contiguity 0.0.9 → 0.1.0

package/dist/services/lease/get.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { E164PhoneNumber, NumberStatus, Carrier } from "@/types/common";
+import { NumberCapabilities, NumberHealth, NumberLocation, NumberFormat, NumberData, NumberPricing } from "@/services/lease/available";
+export const LeaseGetRequest = z.object({
+    /** Phone number in E.164 format to get information about */
+    number: E164PhoneNumber,
+});
+export const LeaseGetResponse = z.object({
+    /** Phone number in E.164 format */
+    id: z.string(),
+    /** Number status */
+    status: NumberStatus,
+    /** Number formats */
+    number: NumberFormat,
+    /** Geographic location */
+    location: NumberLocation,
+    /** Carrier name */
+    carrier: Carrier,
+    /** Number capabilities */
+    capabilities: NumberCapabilities,
+    /** Number health metrics */
+    health: NumberHealth,
+    /** Additional data */
+    data: NumberData,
+    /** Creation timestamp */
+    created_at: z.number(),
+    /** Pricing information */
+    pricing: NumberPricing
+});
+/**
+ * Gets information about a specific number available for lease
+ *
+ * @example
+ * ```typescript
+ * const response = await contiguity.lease.get({
+ *   number: "+1234567890"
+ * });
+ *
+ * console.log(`Number: ${response.number.formatted}`);
+ * console.log(`Location: ${response.location.city}, ${response.location.region}`);
+ * console.log(`Reputation: ${response.health.reputation}`);
+ * console.log(`Monthly rate: $${response.pricing.monthly_rate}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Check if a number supports specific channels
+ * const response = await contiguity.lease.get({
+ *   number: "+1234567890"
+ * });
+ *
+ * const supportsImessage = response.capabilities.channels.includes('imessage');
+ * const supportsWhatsApp = response.capabilities.channels.includes('whatsapp');
+ *
+ * console.log(`iMessage support: ${supportsImessage}`);
+ * console.log(`WhatsApp support: ${supportsWhatsApp}`);
+ * ```
+ */
+export async function _leaseGet(params) {
+    const validatedParams = LeaseGetRequest.parse(params);
+    const response = await this.request(`/numbers/lease/${encodeURIComponent(validatedParams.number)}`, {
+        method: "GET",
+    });
+    return this.parse({
+        response,
+        schema: LeaseGetResponse
+    });
+}

package/dist/services/lease/index.d.ts

@@ -0,0 +1,57 @@
+import { ContiguityClient } from "@/client/fetch";
+import { z } from "zod";
+import { LeaseAvailableResponse } from "@/services/lease/available";
+import { LeaseGetRequest, LeaseGetResponse } from "@/services/lease/get";
+import { LeaseCreateRequest, LeaseCreateResponse } from "@/services/lease/create";
+import { LeaseLeasedResponse } from "@/services/lease/leased";
+import { LeaseDetailsRequest, LeaseDetailsResponse } from "@/services/lease/details";
+import { LeaseTerminateRequest, LeaseTerminateResponse } from "@/services/lease/terminate";
+import { LeaseConfigureRequest, LeaseConfigureResponse } from "@/services/lease/configure";
+import type { WithMetadata } from "@/types/metadata";
+export type LeaseAvailableResponseType = z.infer<typeof LeaseAvailableResponse>;
+export type LeaseGetParams = z.infer<typeof LeaseGetRequest>;
+export type LeaseGetResponseType = z.infer<typeof LeaseGetResponse>;
+export type LeaseCreateParams = z.infer<typeof LeaseCreateRequest>;
+export type LeaseCreateResponseType = z.infer<typeof LeaseCreateResponse>;
+export type LeaseLeasedResponseType = z.infer<typeof LeaseLeasedResponse>;
+export type LeaseDetailsParams = z.infer<typeof LeaseDetailsRequest>;
+export type LeaseDetailsResponseType = z.infer<typeof LeaseDetailsResponse>;
+export type LeaseTerminateParams = z.infer<typeof LeaseTerminateRequest>;
+export type LeaseTerminateResponseType = z.infer<typeof LeaseTerminateResponse>;
+export type LeaseConfigureParams = z.infer<typeof LeaseConfigureRequest>;
+export type LeaseConfigureResponseType = z.infer<typeof LeaseConfigureResponse>;
+/**
+ * Lease service for managing phone number leases
+ */
+export declare class LeaseService extends ContiguityClient {
+    constructor(token: string);
+    /**
+     * Get all phone numbers available for lease
+     */
+    available(): Promise<WithMetadata<LeaseAvailableResponseType>>;
+    /**
+     * Get information about a specific number available for lease
+     */
+    get(params: LeaseGetParams): Promise<WithMetadata<LeaseGetResponseType>>;
+    /**
+     * Lease a specific phone number
+     */
+    create(params: LeaseCreateParams): Promise<WithMetadata<LeaseCreateResponseType>>;
+    /**
+     * Get all phone numbers currently leased by the user
+     */
+    leased(): Promise<WithMetadata<LeaseLeasedResponseType>>;
+    /**
+     * Get information about a specific leased number
+     */
+    details(params: LeaseDetailsParams): Promise<WithMetadata<LeaseDetailsResponseType>>;
+    /**
+     * Terminate your lease for a number
+     */
+    terminate(params: LeaseTerminateParams): Promise<WithMetadata<LeaseTerminateResponseType>>;
+    /**
+     * Configure a leased number (failover, etc.)
+     */
+    configure(params: LeaseConfigureParams): Promise<WithMetadata<LeaseConfigureResponseType>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/services/lease/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/lease/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQlD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,sBAAsB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,eAAe,EACf,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,mBAAmB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEhF;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;gBAClC,KAAK,EAAE,MAAM;IAIzB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAIpE;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAI9E;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IAIvF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IAI9D;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;IAI1F;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAIhG;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;CAGnG"}

package/dist/services/lease/index.js

@@ -0,0 +1,58 @@
+import { ContiguityClient } from "@/client/fetch";
+import { _leaseAvailable } from "@/services/lease/available";
+import { _leaseGet } from "@/services/lease/get";
+import { _leaseCreate } from "@/services/lease/create";
+import { _leasedNumbers } from "@/services/lease/leased";
+import { _leaseDetails } from "@/services/lease/details";
+import { _leaseTerminate } from "@/services/lease/terminate";
+import { _leaseConfigure } from "@/services/lease/configure";
+/**
+ * Lease service for managing phone number leases
+ */
+export class LeaseService extends ContiguityClient {
+    constructor(token) {
+        super(token);
+    }
+    /**
+     * Get all phone numbers available for lease
+     */
+    async available() {
+        return _leaseAvailable.call(this);
+    }
+    /**
+     * Get information about a specific number available for lease
+     */
+    async get(params) {
+        return _leaseGet.call(this, params);
+    }
+    /**
+     * Lease a specific phone number
+     */
+    async create(params) {
+        return _leaseCreate.call(this, params);
+    }
+    /**
+     * Get all phone numbers currently leased by the user
+     */
+    async leased() {
+        return _leasedNumbers.call(this);
+    }
+    /**
+     * Get information about a specific leased number
+     */
+    async details(params) {
+        return _leaseDetails.call(this, params);
+    }
+    /**
+     * Terminate your lease for a number
+     */
+    async terminate(params) {
+        return _leaseTerminate.call(this, params);
+    }
+    /**
+     * Configure a leased number (failover, etc.)
+     */
+    async configure(params) {
+        return _leaseConfigure.call(this, params);
+    }
+}

package/dist/services/lease/leased.d.ts

@@ -0,0 +1,228 @@
+import { z } from "zod";
+export declare const LeasedBillingPeriod: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const LeasedBilling: z.ZodObject<{
+    method: z.ZodEnum<{
+        monthly: "monthly";
+        service_contract: "service_contract";
+        goodwill: "goodwill";
+    }>;
+    period: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const LeasedNumber: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        available: "available";
+        "g-available": "g-available";
+        leased: "leased";
+        unavailable: "unavailable";
+    }>;
+    number: z.ZodObject<{
+        e164: z.ZodString;
+        formatted: z.ZodString;
+    }, z.core.$strip>;
+    location: z.ZodObject<{
+        country: z.ZodString;
+        region: z.ZodString;
+        city: z.ZodString;
+    }, z.core.$strip>;
+    carrier: z.ZodEnum<{
+        "T-Mobile": "T-Mobile";
+        "AT&T": "AT&T";
+        Verizon: "Verizon";
+        Contiguity: "Contiguity";
+        "International Partner": "International Partner";
+        Twilio: "Twilio";
+    }>;
+    capabilities: z.ZodObject<{
+        intl_sms: z.ZodBoolean;
+        channels: z.ZodArray<z.ZodEnum<{
+            sms: "sms";
+            mms: "mms";
+            rcs: "rcs";
+            imessage: "imessage";
+            whatsapp: "whatsapp";
+        }>>;
+    }, z.core.$strip>;
+    health: z.ZodObject<{
+        reputation: z.ZodNumber;
+        previous_owners: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        requirements: z.ZodArray<z.ZodEnum<{
+            imessage_entitlement_required: "imessage_entitlement_required";
+            whatsapp_entitlement_required: "whatsapp_entitlement_required";
+            enterprise_plan_required: "enterprise_plan_required";
+        }>>;
+        e911_capable: z.ZodBoolean;
+    }, z.core.$strip>;
+    created_at: z.ZodNumber;
+    pricing: z.ZodObject<{
+        currency: z.ZodEnum<{
+            USD: "USD";
+            EUR: "EUR";
+            GBP: "GBP";
+            CAD: "CAD";
+            AUD: "AUD";
+        }>;
+        upfront_fee: z.ZodNumber;
+        monthly_rate: z.ZodNumber;
+    }, z.core.$strip>;
+    lease_id: z.ZodString;
+    lease_status: z.ZodEnum<{
+        active: "active";
+        expired: "expired";
+        terminated: "terminated";
+    }>;
+    billing: z.ZodObject<{
+        method: z.ZodEnum<{
+            monthly: "monthly";
+            service_contract: "service_contract";
+            goodwill: "goodwill";
+        }>;
+        period: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const LeaseLeasedResponse: z.ZodObject<{
+    leased: z.ZodNumber;
+    numbers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            available: "available";
+            "g-available": "g-available";
+            leased: "leased";
+            unavailable: "unavailable";
+        }>;
+        number: z.ZodObject<{
+            e164: z.ZodString;
+            formatted: z.ZodString;
+        }, z.core.$strip>;
+        location: z.ZodObject<{
+            country: z.ZodString;
+            region: z.ZodString;
+            city: z.ZodString;
+        }, z.core.$strip>;
+        carrier: z.ZodEnum<{
+            "T-Mobile": "T-Mobile";
+            "AT&T": "AT&T";
+            Verizon: "Verizon";
+            Contiguity: "Contiguity";
+            "International Partner": "International Partner";
+            Twilio: "Twilio";
+        }>;
+        capabilities: z.ZodObject<{
+            intl_sms: z.ZodBoolean;
+            channels: z.ZodArray<z.ZodEnum<{
+                sms: "sms";
+                mms: "mms";
+                rcs: "rcs";
+                imessage: "imessage";
+                whatsapp: "whatsapp";
+            }>>;
+        }, z.core.$strip>;
+        health: z.ZodObject<{
+            reputation: z.ZodNumber;
+            previous_owners: z.ZodNumber;
+        }, z.core.$strip>;
+        data: z.ZodObject<{
+            requirements: z.ZodArray<z.ZodEnum<{
+                imessage_entitlement_required: "imessage_entitlement_required";
+                whatsapp_entitlement_required: "whatsapp_entitlement_required";
+                enterprise_plan_required: "enterprise_plan_required";
+            }>>;
+            e911_capable: z.ZodBoolean;
+        }, z.core.$strip>;
+        created_at: z.ZodNumber;
+        pricing: z.ZodObject<{
+            currency: z.ZodEnum<{
+                USD: "USD";
+                EUR: "EUR";
+                GBP: "GBP";
+                CAD: "CAD";
+                AUD: "AUD";
+            }>;
+            upfront_fee: z.ZodNumber;
+            monthly_rate: z.ZodNumber;
+        }, z.core.$strip>;
+        lease_id: z.ZodString;
+        lease_status: z.ZodEnum<{
+            active: "active";
+            expired: "expired";
+            terminated: "terminated";
+        }>;
+        billing: z.ZodObject<{
+            method: z.ZodEnum<{
+                monthly: "monthly";
+                service_contract: "service_contract";
+                goodwill: "goodwill";
+            }>;
+            period: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LeaseLeasedResponseType = z.infer<typeof LeaseLeasedResponse>;
+export type LeasedNumberType = z.infer<typeof LeasedNumber>;
+/**
+ * Gets all phone numbers currently leased by the user
+ *
+ * @example
+ * ```typescript
+ * const response = await contiguity.lease.leased();
+ * console.log(`You have ${response.leased} leased numbers`);
+ *
+ * // List all active leases
+ * const activeLeases = response.numbers.filter(
+ *   num => num.lease_status === 'active'
+ * );
+ * console.log(`Active leases: ${activeLeases.length}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Find leases by capabilities
+ * const response = await contiguity.lease.leased();
+ *
+ * const imessageNumbers = response.numbers.filter(
+ *   num => num.capabilities.channels.includes('imessage')
+ * );
+ *
+ * const whatsappNumbers = response.numbers.filter(
+ *   num => num.capabilities.channels.includes('whatsapp')
+ * );
+ *
+ * console.log(`iMessage numbers: ${imessageNumbers.length}`);
+ * console.log(`WhatsApp numbers: ${whatsappNumbers.length}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Check lease expiration dates
+ * const response = await contiguity.lease.leased();
+ *
+ * response.numbers.forEach(num => {
+ *   console.log(`${num.number.formatted}:`);
+ *   console.log(`  Lease ID: ${num.lease_id}`);
+ *   console.log(`  Status: ${num.lease_status}`);
+ *
+ *   if (num.billing.period.end) {
+ *     const endDate = new Date(num.billing.period.end * 1000);
+ *     console.log(`  Expires: ${endDate.toLocaleDateString()}`);
+ *   } else {
+ *     console.log(`  Billing: Month-to-month`);
+ *   }
+ * });
+ * ```
+ */
+export declare function _leasedNumbers(this: any): Promise<any>;
+//# sourceMappingURL=leased.d.ts.map

package/dist/services/lease/leased.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leased.d.ts","sourceRoot":"","sources":["../../../src/services/lease/leased.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,mBAAmB;;;iBAK9B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;iBAKxB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BvB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAKH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAS5D"}

package/dist/services/lease/leased.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { NumberCapabilities, NumberHealth, NumberLocation, NumberFormat, NumberData, NumberPricing } from "@/services/lease/available";
+export const LeasedBillingPeriod = z.object({
+    /** Lease start timestamp */
+    start: z.number(),
+    /** Lease end timestamp. Null if month-to-month with no set cancellation date */
+    end: z.number().nullable()
+});
+export const LeasedBilling = z.object({
+    /** Billing method */
+    method: z.enum(["monthly", "service_contract", "goodwill"]),
+    /** Lease billing period */
+    period: LeasedBillingPeriod
+});
+export const LeasedNumber = z.object({
+    /** Phone number in E.164 format */
+    id: z.string(),
+    /** Number status (leased) */
+    status: z.enum(["available", "g-available", "leased", "unavailable"]),
+    /** Number formats */
+    number: NumberFormat,
+    /** Geographic location */
+    location: NumberLocation,
+    /** Carrier name */
+    carrier: z.enum(["T-Mobile", "AT&T", "Verizon", "Twilio", "Contiguity", "International Partner"]),
+    /** Number capabilities */
+    capabilities: NumberCapabilities,
+    /** Number health metrics */
+    health: NumberHealth,
+    /** Additional data */
+    data: NumberData,
+    /** Creation timestamp */
+    created_at: z.number(),
+    /** Pricing information */
+    pricing: NumberPricing,
+    /** Lease ID */
+    lease_id: z.string(),
+    /** Lease status */
+    lease_status: z.enum(["active", "expired", "terminated"]),
+    /** Lease billing information */
+    billing: LeasedBilling
+});
+export const LeaseLeasedResponse = z.object({
+    /** Number of leased numbers */
+    leased: z.number(),
+    /** User's leased numbers */
+    numbers: z.array(LeasedNumber)
+});
+/**
+ * Gets all phone numbers currently leased by the user
+ *
+ * @example
+ * ```typescript
+ * const response = await contiguity.lease.leased();
+ * console.log(`You have ${response.leased} leased numbers`);
+ *
+ * // List all active leases
+ * const activeLeases = response.numbers.filter(
+ *   num => num.lease_status === 'active'
+ * );
+ * console.log(`Active leases: ${activeLeases.length}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Find leases by capabilities
+ * const response = await contiguity.lease.leased();
+ *
+ * const imessageNumbers = response.numbers.filter(
+ *   num => num.capabilities.channels.includes('imessage')
+ * );
+ *
+ * const whatsappNumbers = response.numbers.filter(
+ *   num => num.capabilities.channels.includes('whatsapp')
+ * );
+ *
+ * console.log(`iMessage numbers: ${imessageNumbers.length}`);
+ * console.log(`WhatsApp numbers: ${whatsappNumbers.length}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Check lease expiration dates
+ * const response = await contiguity.lease.leased();
+ *
+ * response.numbers.forEach(num => {
+ *   console.log(`${num.number.formatted}:`);
+ *   console.log(`  Lease ID: ${num.lease_id}`);
+ *   console.log(`  Status: ${num.lease_status}`);
+ *
+ *   if (num.billing.period.end) {
+ *     const endDate = new Date(num.billing.period.end * 1000);
+ *     console.log(`  Expires: ${endDate.toLocaleDateString()}`);
+ *   } else {
+ *     console.log(`  Billing: Month-to-month`);
+ *   }
+ * });
+ * ```
+ */
+export async function _leasedNumbers() {
+    const response = await this.request("/numbers/leased", {
+        method: "GET",
+    });
+    return this.parse({
+        response,
+        schema: LeaseLeasedResponse
+    });
+}

package/dist/services/lease/terminate.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+export declare const LeaseTerminateRequest: z.ZodObject<{
+    number: z.ZodString;
+}, z.core.$strip>;
+export declare const LeaseTerminateResponse: z.ZodObject<{
+    lease_id: z.ZodString;
+    number_id: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        expired: "expired";
+        terminated: "terminated";
+    }>;
+    terminated_at: z.ZodNumber;
+}, z.core.$strip>;
+export type LeaseTerminateParams = z.infer<typeof LeaseTerminateRequest>;
+export type LeaseTerminateResponseType = z.infer<typeof LeaseTerminateResponse>;
+/**
+ * Terminates your lease for a number
+ *
+ * @example
+ * ```typescript
+ * const response = await contiguity.lease.terminate({
+ *   number: "+1234567890"
+ * });
+ *
+ * console.log(`Lease ${response.lease_id} terminated`);
+ * console.log(`Number: ${response.number_id}`);
+ * console.log(`Status: ${response.status}`);
+ * console.log(`Terminated at: ${new Date(response.terminated_at * 1000)}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Terminate lease with confirmation
+ * try {
+ *   const response = await contiguity.lease.terminate({
+ *     number: "+1234567890"
+ *   });
+ *
+ *   if (response.status === 'terminated') {
+ *     console.log('✓ Lease successfully terminated');
+ *     console.log(`Termination date: ${new Date(response.terminated_at * 1000).toLocaleDateString()}`);
+ *   }
+ * } catch (error) {
+ *   console.error('Failed to terminate lease:', error.message);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Bulk terminate multiple leases
+ * const numbersToTerminate = ["+1234567890", "+0987654321"];
+ *
+ * const results = await Promise.allSettled(
+ *   numbersToTerminate.map(number =>
+ *     contiguity.lease.terminate({ number })
+ *   )
+ * );
+ *
+ * results.forEach((result, index) => {
+ *   const number = numbersToTerminate[index];
+ *   if (result.status === 'fulfilled') {
+ *     console.log(`✓ ${number}: Lease terminated`);
+ *   } else {
+ *     console.log(`✗ ${number}: Failed to terminate - ${result.reason.message}`);
+ *   }
+ * });
+ * ```
+ */
+export declare function _leaseTerminate(this: any, params: LeaseTerminateParams): Promise<any>;
+//# sourceMappingURL=terminate.d.ts.map

package/dist/services/lease/terminate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminate.d.ts","sourceRoot":"","sources":["../../../src/services/lease/terminate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;iBAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;iBASjC,CAAC;AAKH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,CAU3F"}

package/dist/services/lease/terminate.js

@@ -0,0 +1,78 @@
+import { z } from "zod";
+export const LeaseTerminateRequest = z.object({
+    /** Phone number in E.164 format to terminate lease for */
+    number: z.string().regex(/^\+[1-9]\d{1,14}$/, "Phone number must be in E.164 format"),
+});
+export const LeaseTerminateResponse = z.object({
+    /** Terminated lease ID */
+    lease_id: z.string(),
+    /** Number ID */
+    number_id: z.string(),
+    /** The lease's new status */
+    status: z.enum(["active", "expired", "terminated"]),
+    /** Termination timestamp */
+    terminated_at: z.number()
+});
+/**
+ * Terminates your lease for a number
+ *
+ * @example
+ * ```typescript
+ * const response = await contiguity.lease.terminate({
+ *   number: "+1234567890"
+ * });
+ *
+ * console.log(`Lease ${response.lease_id} terminated`);
+ * console.log(`Number: ${response.number_id}`);
+ * console.log(`Status: ${response.status}`);
+ * console.log(`Terminated at: ${new Date(response.terminated_at * 1000)}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Terminate lease with confirmation
+ * try {
+ *   const response = await contiguity.lease.terminate({
+ *     number: "+1234567890"
+ *   });
+ *
+ *   if (response.status === 'terminated') {
+ *     console.log('✓ Lease successfully terminated');
+ *     console.log(`Termination date: ${new Date(response.terminated_at * 1000).toLocaleDateString()}`);
+ *   }
+ * } catch (error) {
+ *   console.error('Failed to terminate lease:', error.message);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Bulk terminate multiple leases
+ * const numbersToTerminate = ["+1234567890", "+0987654321"];
+ *
+ * const results = await Promise.allSettled(
+ *   numbersToTerminate.map(number =>
+ *     contiguity.lease.terminate({ number })
+ *   )
+ * );
+ *
+ * results.forEach((result, index) => {
+ *   const number = numbersToTerminate[index];
+ *   if (result.status === 'fulfilled') {
+ *     console.log(`✓ ${number}: Lease terminated`);
+ *   } else {
+ *     console.log(`✗ ${number}: Failed to terminate - ${result.reason.message}`);
+ *   }
+ * });
+ * ```
+ */
+export async function _leaseTerminate(params) {
+    const validatedParams = LeaseTerminateRequest.parse(params);
+    const response = await this.request(`/numbers/leased/${encodeURIComponent(validatedParams.number)}`, {
+        method: "DELETE",
+    });
+    return this.parse({
+        response,
+        schema: LeaseTerminateResponse
+    });
+}