niazpardaz_sms 1.0.2

data/lib/niazpardaz_sms/models/result_codes.rb

@@ -0,0 +1,440 @@
+# frozen_string_literal: true
+
+module NiazpardazSms
+  module Models
+    # کدهای نتیجه ارسال پیامک
+    module SendResultCode
+      SEND_WAS_SUCCESSFUL = 0                                    # ارسال با موفقیت انجام شد
+      INVALID_USER_NAME_OR_PASSWORD = 1                          # نام کاربر یا کلمه عبور نامعتبر می باشد
+      USER_BLOCKED = 2                                           # کاربر مسدود شده است
+      INVALID_SENDER_NUMBER = 3                                  # شماره فرستنده نامعتبر است
+      LIMITATION_IN_DAILY_SEND = 4                               # محدودیت در ارسال روزانه
+      LIMITATION_IN_RECEIVER_COUNT = 5                           # تعداد گیرندگان حداکثر 1000 شماره می باشد
+      SENDER_LINE_IS_INACTIVE = 6                                # خط فرستنده غیرفعال است
+      SMS_CONTENT_FILTERED_WORDS_IS_INCLUDED = 7                 # متن پیامک شامل کلمات فیلتر شده است
+      NO_CREDIT = 8                                              # اعتبار کافی نیست
+      SYSTEM_BEING_UPDATED = 9                                   # سامانه در حال بروز رسانی است
+      WEB_SERVICE_NOT_ACTIVE = 10                                # وب سرویس غیرفعال است
+      NOT_IMPLEMENTED = 11                                       # پیاده سازی نشده است
+      LIKE_TO_LIKE_RECEIVER_AND_MESSAGE_COUNT_SHOULD_EQUAL = 12  # تعداد پیامها و شماره ها باید یکسان باشد
+      LIMITATION_IN_MESSAGE_CONTENT_COUNT = 13                   # تعداد پیامها حداکثر 100 پیام می باشد
+      USER_TARIFF_NOT_DETERMINED = 14                            # هیچ مقداری برای تعرفه جاری کاربر تعریف نشده است
+      DUPLICATE_SEND_SMS = 15                                    # ارسال تکراری متن مشابه به شماره مشابه
+      INVALID_NUMBER_EMPTY_OR_BLACKLIST = 16                     # شماره موبایل گیرنده یافت نشد
+      TEXT_NOT_FOUND = 17                                        # متن وارد نشده است
+      NOT_VALID_TEMPLATE_FOUND = 18                              # متن طبق الگوی تعریف شده نیست
+      USER_EXPIRED = 19                                          # کاربر منقضی شده است
+      USER_IS_NOT_ACTIVE = 20                                    # وضعیت کاربر فعال نیست
+      INVALID_PARAMETERS = 21                                    # مقدار یکی یا بیشتر از پارامترهای ورودی معتبر نیست
+      IP_BLOCKED = 22                                            # آی پی موقت بلاک شده است
+      ENQUEUE_FAILED = 23                                        # عملیات با خطا مواجه شد
+      DUPLICATE_REQUEST_THRESHOLD = 24                           # درخواست کاملا تکراری در بازه کوتاه
+      INVALID_API_KEY = 25                                       # ApiKey نامعتبر
+      ERROR_CREATE_VOICE_FILE = 26                               # خطا در ساخت فایل صوتی
+
+      DESCRIPTIONS = {
+        SEND_WAS_SUCCESSFUL => 'ارسال با موفقیت انجام شد',
+        INVALID_USER_NAME_OR_PASSWORD => 'نام کاربر یا کلمه عبور نامعتبر می باشد',
+        USER_BLOCKED => 'کاربر مسدود شده است',
+        INVALID_SENDER_NUMBER => 'شماره فرستنده نامعتبر است',
+        LIMITATION_IN_DAILY_SEND => 'محدودیت در ارسال روزانه',
+        LIMITATION_IN_RECEIVER_COUNT => 'تعداد گیرندگان حداکثر 1000 شماره می باشد',
+        SENDER_LINE_IS_INACTIVE => 'خط فرستنده غیرفعال است',
+        SMS_CONTENT_FILTERED_WORDS_IS_INCLUDED => 'متن پیامک شامل کلمات فیلتر شده است',
+        NO_CREDIT => 'اعتبار کافی نیست',
+        SYSTEM_BEING_UPDATED => 'سامانه در حال بروز رسانی است',
+        WEB_SERVICE_NOT_ACTIVE => 'وب سرویس غیرفعال است',
+        NOT_IMPLEMENTED => 'پیاده سازی نشده است',
+        LIKE_TO_LIKE_RECEIVER_AND_MESSAGE_COUNT_SHOULD_EQUAL => 'تعداد پیامها و شماره ها باید یکسان باشد',
+        LIMITATION_IN_MESSAGE_CONTENT_COUNT => 'تعداد پیامها حداکثر 100 پیام می باشد',
+        USER_TARIFF_NOT_DETERMINED => 'هیچ مقداری برای تعرفه جاری کاربر تعریف نشده است',
+        DUPLICATE_SEND_SMS => 'ارسال تکراری متن مشابه به شماره مشابه',
+        INVALID_NUMBER_EMPTY_OR_BLACKLIST => 'شماره موبایل گیرنده یافت نشد',
+        TEXT_NOT_FOUND => 'متن وارد نشده است',
+        NOT_VALID_TEMPLATE_FOUND => 'متن طبق الگوی تعریف شده نیست',
+        USER_EXPIRED => 'کاربر منقضی شده است',
+        USER_IS_NOT_ACTIVE => 'وضعیت کاربر فعال نیست',
+        INVALID_PARAMETERS => 'مقدار یکی یا بیشتر از پارامترهای ورودی معتبر نیست',
+        IP_BLOCKED => 'آی پی موقت بلاک شده است',
+        ENQUEUE_FAILED => 'عملیات با خطا مواجه شد',
+        DUPLICATE_REQUEST_THRESHOLD => 'درخواست کاملا تکراری در بازه کوتاه',
+        INVALID_API_KEY => 'ApiKey نامعتبر',
+        ERROR_CREATE_VOICE_FILE => 'خطا در ساخت فایل صوتی'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SEND_WAS_SUCCESSFUL
+      end
+    end
+
+    # کدهای نتیجه گزارش تحویل
+    module DeliveryResultCode
+      SUCCESS = 0                    # موفق
+      SERVICE_CONNECTION_ERROR = -1  # خطا در ارتباط با سرویس دهنده
+      INVALID_BATCH_SMS_ID = -2      # پیام با این کد وجود ندارد
+      REPORT_EXPIRED = -3            # مهلت یک هفته ای گرفتن گزارش پایان یافته است
+      MESSAGE_IN_QUEUE = -4          # پیام در صف ارسال مخابرات است
+      TOO_EARLY = -5                 # حداقل یک دقیقه بعد از ارسال اقدام نمایید
+      IP_BLOCKED = -6                # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7           # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'موفق',
+        SERVICE_CONNECTION_ERROR => 'خطا در ارتباط با سرویس دهنده',
+        INVALID_BATCH_SMS_ID => 'پیام با این کد وجود ندارد',
+        REPORT_EXPIRED => 'مهلت یک هفته ای گرفتن گزارش پایان یافته است',
+        MESSAGE_IN_QUEUE => 'پیام در صف ارسال مخابرات است',
+        TOO_EARLY => 'حداقل یک دقیقه بعد از ارسال اقدام نمایید',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # وضعیت تحویل پیامک
+    module SmsDeliveryStatus
+      NONE = -10                  # نامشخص
+      SENT_TO_TELECOM = 0         # ارسال شده به مخابرات
+      DELIVERED = 1               # رسیده به گوشی
+      NOT_DELIVERED = 2           # نرسیده به گوشی
+      SMS_FAILED = 3              # خطای مخابراتی
+      UNKNOWN_ERROR = 4           # خطای نامشخص
+      RECEIVED_BY_TELECOM = 5     # رسیده به مخابرات
+      NOT_RECEIVED_BY_TELECOM = 6 # نرسیده به مخابرات
+      BLACKLISTED = 7             # مسدود شده توسط مقصد
+      UNKNOWN = 8                 # نامشخص
+      REJECTED_BY_TELECOM = 9     # مخابرات پیام را مردود اعلام کرد
+      CANCELED = 10               # کنسل شده توسط اپراتور
+      NOT_SENT = 11               # ارسال نشده
+      NO_TELEGRAM = 12            # تلگرام ندارد
+      IN_QUEUE = 13               # در صف ارسال
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        SENT_TO_TELECOM => 'ارسال شده به مخابرات',
+        DELIVERED => 'رسیده به گوشی',
+        NOT_DELIVERED => 'نرسیده به گوشی',
+        SMS_FAILED => 'خطای مخابراتی',
+        UNKNOWN_ERROR => 'خطای نامشخص',
+        RECEIVED_BY_TELECOM => 'رسیده به مخابرات',
+        NOT_RECEIVED_BY_TELECOM => 'نرسیده به مخابرات',
+        BLACKLISTED => 'مسدود شده توسط مقصد',
+        UNKNOWN => 'نامشخص',
+        REJECTED_BY_TELECOM => 'مخابرات پیام را مردود اعلام کرد',
+        CANCELED => 'کنسل شده توسط اپراتور',
+        NOT_SENT => 'ارسال نشده',
+        NO_TELEGRAM => 'تلگرام ندارد',
+        IN_QUEUE => 'در صف ارسال'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.delivered?(code)
+        code == DELIVERED
+      end
+    end
+
+    # کدهای نتیجه اعتبار
+    module CreditResultCode
+      SUCCESS = 0              # موفق
+      INVALID_CREDENTIALS = -1 # نام کاربری و رمز عبور صحیح نمی باشد
+      USER_DISABLED = -2       # کاربر غیرفعال می باشد
+      IP_BLOCKED = -6          # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7     # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'موفق',
+        INVALID_CREDENTIALS => 'نام کاربری و رمز عبور صحیح نمی باشد',
+        USER_DISABLED => 'کاربر غیرفعال می باشد',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # کدهای نتیجه لیست سیاه
+    module BlacklistResultCode
+      SUCCESS = 0               # عملیات با موفقیت انجام شد
+      INVALID_CREDENTIALS = -1  # نام کاربری و رمز عبور صحیح نمی باشد
+      USER_DISABLED = -2        # کاربر غیرفعال می باشد
+      EMPTY_NUMBERS_ARRAY = -3  # آرایه شماره های همراه خالی می باشد
+      MAX_NUMBERS_EXCEEDED = -4 # تعداد شماره ها حداکثر 1000 شماره می باشد
+      IP_BLOCKED = -6           # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7      # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'عملیات با موفقیت انجام شد',
+        INVALID_CREDENTIALS => 'نام کاربری و رمز عبور صحیح نمی باشد',
+        USER_DISABLED => 'کاربر غیرفعال می باشد',
+        EMPTY_NUMBERS_ARRAY => 'آرایه شماره های همراه خالی می باشد',
+        MAX_NUMBERS_EXCEEDED => 'تعداد شماره ها حداکثر 1000 شماره می باشد',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # کدهای نتیجه شماره های ارسال کننده
+    module SenderNumbersResultCode
+      SUCCESS = 0              # موفق
+      INVALID_CREDENTIALS = -1 # نام کاربری و رمز عبور صحیح نمی باشد
+      USER_DISABLED = -2       # کاربر غیرفعال می باشد
+      IP_BLOCKED = -6          # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7     # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'موفق',
+        INVALID_CREDENTIALS => 'نام کاربری و رمز عبور صحیح نمی باشد',
+        USER_DISABLED => 'کاربر غیرفعال می باشد',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # کدهای نتیجه تعداد پیامک های دریافتی
+    module InboxCountResultCode
+      SUCCESS = 0              # موفق
+      INVALID_CREDENTIALS = -1 # نام کاربری و رمز عبور صحیح نمی باشد
+      USER_DISABLED = -2       # کاربر غیرفعال می باشد
+      IP_BLOCKED = -6          # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7     # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'موفق',
+        INVALID_CREDENTIALS => 'نام کاربری و رمز عبور صحیح نمی باشد',
+        USER_DISABLED => 'کاربر غیرفعال می باشد',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # کدهای نتیجه بررسی محتوای پیامک
+    module CheckContentResultCode
+      SUCCESS = 0              # موفق
+      INVALID_CREDENTIALS = -1 # نام کاربری و رمز عبور صحیح نمی باشد
+      USER_DISABLED = -2       # کاربر غیرفعال می باشد
+      IP_BLOCKED = -6          # آی پی موقتا بلاک شده است
+      INVALID_API_KEY = -7     # ApiKey نامعتبر
+
+      DESCRIPTIONS = {
+        SUCCESS => 'موفق',
+        INVALID_CREDENTIALS => 'نام کاربری و رمز عبور صحیح نمی باشد',
+        USER_DISABLED => 'کاربر غیرفعال می باشد',
+        IP_BLOCKED => 'آی پی موقتا بلاک شده است',
+        INVALID_API_KEY => 'ApiKey نامعتبر'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+
+      def self.success?(code)
+        code == SUCCESS
+      end
+    end
+
+    # زبان پیامک
+    module SmsLangType
+      NONE = -10 # نامشخص
+      FA = 1     # فارسی
+      EN = 2     # انگلیسی
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        FA => 'فارسی',
+        EN => 'انگلیسی'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+    end
+
+    # وضعیت پیامک
+    module SmsStatusType
+      NONE = -10              # نامشخص
+      PENDING = 1             # منتظر تایید
+      ILLEGAL = 2             # غیر مجاز
+      SENDING = 3             # در حال ارسال
+      NOT_APPROVED = 4        # تایید نشده
+      SENT = 5                # ارسال شده
+      CANCELED = 6            # انصراف
+      ERROR = 7               # توقف ارسال
+      NO_CREDIT = 8           # مبلغ شارژ جهت ارسال کافی نیست
+      NOT_SENT = 9            # ارسال نشده
+      WAIT_FOR_SEND = 10      # منتظر ارسال
+      PENDING_DEC_COST = 11   # در حال کسر هزینه
+      IN_QUEUE = 12           # در صف منتظر ارسال
+      MANY_TO_MANY_CALC_COST = 13 # در حال کسر هزینه چند به چند
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        PENDING => 'منتظر تایید',
+        ILLEGAL => 'غیر مجاز',
+        SENDING => 'در حال ارسال',
+        NOT_APPROVED => 'تایید نشده',
+        SENT => 'ارسال شده',
+        CANCELED => 'انصراف',
+        ERROR => 'توقف ارسال',
+        NO_CREDIT => 'مبلغ شارژ جهت ارسال کافی نیست',
+        NOT_SENT => 'ارسال نشده',
+        WAIT_FOR_SEND => 'منتظر ارسال',
+        PENDING_DEC_COST => 'در حال کسر هزینه',
+        IN_QUEUE => 'در صف منتظر ارسال',
+        MANY_TO_MANY_CALC_COST => 'در حال کسر هزینه چند به چند'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+    end
+
+    # وضعیت ارسال پیامک
+    module SmsSendStatusType
+      NONE = -10      # نامشخص
+      SENT = 1        # ارسال شده
+      ERROR = 2       # خطای مخابراتی
+      BLOCK_LIST = 3  # خط مقصد دریافت از خطوط پیامک را مسدود کرده است
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        SENT => 'ارسال شده',
+        ERROR => 'خطای مخابراتی',
+        BLOCK_LIST => 'خط مقصد دریافت از خطوط پیامک را مسدود کرده است'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+    end
+
+    # روش ارسال
+    module SmsSendMethodType
+      NONE = -10                  # نامشخص
+      QUICK = 1                   # سریع
+      TEST = 2                    # تست
+      REGIONAL = 3                # منطقه ای
+      GROUP = 4                   # گروهی
+      WEB_SERVICE = 5             # وب سرویس
+      ANNOUNCEMENT = 6            # اطلاع رسانی
+      SECRETARY = 7               # منشی
+      INTELLIGENT_SEND = 8        # ارسال هوشمند
+      CORRESPONDING_SEND = 9      # ارسال متناظر
+      CODE_READER = 10            # کد خوان
+      POLL = 11                   # نظرسنجی
+      TRANSFER = 12               # انتقال پیامک
+      REPLY = 13                  # پاسخ
+      PHONE_BOOK = 14             # ارسال از دفتر تلفن
+      POSTAL_CODE = 15            # ارسال کد پستی
+      SMS_EVENT = 16              # پیامک مناسبت
+      INTELLIGENT_SECRETARY = 17  # منشی هوشمند
+      ADD_TO_PHONE_BOOK = 18      # اضافه به لیست
+      INSTANT_SMS = 19            # پیامک فوری
+      SCHEDULE_SMS = 20           # پیامک زماندار
+      USANCE_SMS = 21             # پیامک سررسید
+      AGE_AND_GENDER = 22         # سن و جنسیت
+      SYSTEM = 23                 # سیستمی
+      BIRTHDAY_SMS = 24           # ارسال تولد
+      KIOSK_SMS = 25              # کیوسک
+      CANCELLATION_BY_11 = 26     # لغو11
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        QUICK => 'سریع',
+        TEST => 'تست',
+        REGIONAL => 'منطقه ای',
+        GROUP => 'گروهی',
+        WEB_SERVICE => 'وب سرویس',
+        ANNOUNCEMENT => 'اطلاع رسانی',
+        SECRETARY => 'منشی',
+        INTELLIGENT_SEND => 'ارسال هوشمند',
+        CORRESPONDING_SEND => 'ارسال متناظر',
+        CODE_READER => 'کد خوان',
+        POLL => 'نظرسنجی',
+        TRANSFER => 'انتقال پیامک',
+        REPLY => 'پاسخ',
+        PHONE_BOOK => 'ارسال از دفتر تلفن',
+        POSTAL_CODE => 'ارسال کد پستی',
+        SMS_EVENT => 'پیامک مناسبت',
+        INTELLIGENT_SECRETARY => 'منشی هوشمند',
+        ADD_TO_PHONE_BOOK => 'اضافه به لیست',
+        INSTANT_SMS => 'پیامک فوری',
+        SCHEDULE_SMS => 'پیامک زماندار',
+        USANCE_SMS => 'پیامک سررسید',
+        AGE_AND_GENDER => 'سن و جنسیت',
+        SYSTEM => 'سیستمی',
+        BIRTHDAY_SMS => 'ارسال تولد',
+        KIOSK_SMS => 'کیوسک',
+        CANCELLATION_BY_11 => 'لغو11'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+    end
+
+    # نوع مسیر پیامک
+    module SmsDirectionType
+      NONE = -10     # نامشخص
+      IN = 1         # دریافتی
+      OUT = 2        # ارسالی
+      SCHEDULE = 3   # زماندار
+      USANCE = 4     # سررسید
+
+      DESCRIPTIONS = {
+        NONE => 'نامشخص',
+        IN => 'دریافتی',
+        OUT => 'ارسالی',
+        SCHEDULE => 'زماندار',
+        USANCE => 'سررسید'
+      }.freeze
+
+      def self.description(code)
+        DESCRIPTIONS[code] || 'کد نامشخص'
+      end
+    end
+  end
+end

data/lib/niazpardaz_sms/railtie.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module NiazpardazSms
+  # Railtie برای یکپارچگی با Rails
+  #
+  # این کلاس به صورت خودکار توسط Rails بارگذاری می‌شود و امکانات زیر را فراهم می‌کند:
+  # - بارگذاری خودکار generators
+  # - پیکربندی از طریق Rails credentials
+  #
+  class Railtie < Rails::Railtie
+    # بارگذاری generators
+    generators do
+      require_relative '../generators/niazpardaz_sms/install/install_generator'
+    end
+
+    # پیکربندی اولیه
+    initializer 'niazpardaz_sms.configure' do |app|
+      # اگر credentials تنظیم شده باشد، از آن استفاده کن
+      if app.credentials.respond_to?(:niazpardaz_sms)
+        credentials = app.credentials.niazpardaz_sms
+        NiazpardazSms.default_api_key ||= credentials[:api_key] if credentials[:api_key]
+        NiazpardazSms.default_timeout ||= credentials[:timeout] if credentials[:timeout]
+        NiazpardazSms.default_base_url ||= credentials[:base_url] if credentials[:base_url]
+      end
+    end
+
+    # Rake tasks (در صورت نیاز)
+    rake_tasks do
+      # می‌توانید rake tasks اضافه کنید
+    end
+  end
+end

data/lib/niazpardaz_sms/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NiazpardazSms
+  VERSION = '1.0.2'
+end

data/lib/niazpardaz_sms.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative 'niazpardaz_sms/version'
+require_relative 'niazpardaz_sms/errors/niazpardaz_api_error'
+require_relative 'niazpardaz_sms/models/result_codes'
+require_relative 'niazpardaz_sms/models/responses'
+require_relative 'niazpardaz_sms/client'
+
+# بارگذاری Railtie در صورت وجود Rails
+require_relative 'niazpardaz_sms/railtie' if defined?(Rails::Railtie)
+
+# کتابخانه رسمی Ruby برای کار با API پیامکی نیازپرداز
+#
+# @example استفاده ساده
+#   client = NiazpardazSms::Client.new('YOUR_API_KEY')
+#   result = client.send_sms(
+#     from_number: '10001234',
+#     to_number: '09123456789',
+#     message: 'سلام از نیازپرداز!'
+#   )
+#
+# @example با تنظیمات سفارشی
+#   client = NiazpardazSms::Client.new('YOUR_API_KEY', timeout: 60)
+#
+module NiazpardazSms
+  class << self
+    # تنظیمات پیش‌فرض
+    attr_accessor :default_api_key, :default_timeout, :default_base_url
+
+    # ایجاد کلاینت با تنظیمات پیش‌فرض
+    #
+    # @param api_key [String, nil] کلید API (اختیاری اگر default_api_key تنظیم شده باشد)
+    # @param options [Hash] تنظیمات اختیاری
+    # @return [Client] کلاینت جدید
+    def client(api_key = nil, options = {})
+      key = api_key || default_api_key
+      opts = {
+        timeout: default_timeout,
+        base_url: default_base_url
+      }.compact.merge(options)
+
+      Client.new(key, opts)
+    end
+
+    # پیکربندی کتابخانه
+    #
+    # @yield [self] بلوک پیکربندی
+    # @example
+    #   NiazpardazSms.configure do |config|
+    #     config.default_api_key = 'YOUR_API_KEY'
+    #     config.default_timeout = 60
+    #   end
+    def configure
+      yield self
+    end
+
+    # ریست کردن تنظیمات
+    def reset_configuration!
+      @default_api_key = nil
+      @default_timeout = nil
+      @default_base_url = nil
+    end
+  end
+end
+
+# Alias برای دسترسی آسان‌تر
+Niazpardaz = NiazpardazSms unless defined?(Niazpardaz)

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: niazpardaz_sms
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Niazpardaz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-net_http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: کتابخانه رسمی Ruby برای ارسال پیامک، دریافت گزارش تحویل، مدیریت لیست
+  سیاه و سایر امکانات API پیامکی نیازپرداز. سازگار با Rails، Sinatra و سایر فریم‌ورک‌های
+  Ruby. برای خرید پنل می توانید به سایت https://niazpardaz-sms.com مراجعه نمایید.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/generators/niazpardaz_sms/install/install_generator.rb
+- lib/generators/niazpardaz_sms/install/templates/README
+- lib/generators/niazpardaz_sms/install/templates/niazpardaz_sms.rb
+- lib/niazpardaz_sms.rb
+- lib/niazpardaz_sms/client.rb
+- lib/niazpardaz_sms/errors/niazpardaz_api_error.rb
+- lib/niazpardaz_sms/models/responses.rb
+- lib/niazpardaz_sms/models/result_codes.rb
+- lib/niazpardaz_sms/railtie.rb
+- lib/niazpardaz_sms/version.rb
+homepage: https://github.com/NiazpardazSms/niazpardaz-sms-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/NiazpardazSms/niazpardaz-sms-ruby
+  source_code_uri: https://github.com/NiazpardazSms/niazpardaz-sms-ruby
+  changelog_uri: https://github.com/NiazpardazSms/niazpardaz-sms-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://niazpardaz-sms.com/webservice
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: کتابخانه رسمی Ruby برای کار با API پیامکی نیازپرداز
+test_files: []