fastlane-plugin-appscert 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c6ba0d2a6dcb15ac98b613d9dceef4b3efdf962a4306c961fe351b977d42949b
+  data.tar.gz: 11dc2aa82f684f6683788812aa50707a18d52113c00ef60acf060062f55adb29
+SHA512:
+  metadata.gz: 0a076e34f12001f542fb153201ee902bcf0a59a0422198a124d620918c6c3e221731a68a89bf9d687e27db4e394679f26badbd4f350f3c141cfa2221a2cbb176
+  data.tar.gz: 17a2e7cdaa7376e705bc78b546b97c13ce9eda405e1b2b096ef04481106fe26ace10305072ec731ea375a180964a11782b413ef85872a2062c0b30d2bf39cf10

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AppsCert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,56 @@
+# fastlane-plugin-appscert
+
+[![Gem Version](https://badge.fury.io/rb/fastlane-plugin-appscert.svg)](https://rubygems.org/gems/fastlane-plugin-appscert)
+
+Fastlane plugin for [AppsCert](https://appscert.com) — Apple certificate & provisioning profile management.
+
+## Installation
+
+```bash
+gem install fastlane-plugin-appscert
+```
+
+Or add to your `Gemfile`:
+
+```ruby
+gem 'fastlane-plugin-appscert'
+```
+
+## Actions
+
+### `appscert_sync`
+
+Sync (download) all certificates and provisioning profiles from AppsCert.
+
+```ruby
+lane :sync do
+  appscert_sync(
+    appscert_api_key: "your_key",  # or set APPSCERT_API_KEY env
+    output_path: "./certs",
+    include_profiles: true
+  )
+end
+```
+
+### `appscert_check`
+
+Check expiration status. Fails the build if any cert/profile expires within N days.
+
+```ruby
+lane :check do
+  appscert_check(
+    days_before_expiry: 30,
+    fail_on_expiring: true
+  )
+end
+```
+
+## Configuration
+
+Set `APPSCERT_API_KEY` environment variable or pass `appscert_api_key` parameter.
+
+Get your API key at [appscert.com/dashboard/api-keys](https://appscert.com/dashboard/api-keys).
+
+## License
+
+MIT

data/lib/fastlane/plugin/appscert/actions/appscert_check.rb

@@ -0,0 +1,75 @@
+require 'date'
+
+module Fastlane
+  module Actions
+    class AppscertCheckAction < Action
+      def self.run(params)
+        api_key = params[:appscert_api_key] || ENV['APPSCERT_API_KEY']
+        UI.user_error!("No AppsCert API key provided.") unless api_key
+
+        base_url = params[:api_base_url]
+        days_threshold = params[:days_before_expiry] || 30
+        fail_on_expiring = params[:fail_on_expiring] != false
+
+        UI.message("🔍 Checking certificate expiration (threshold: #{days_threshold} days)...")
+
+        certs = Helper::AppscertHelper.fetch_certificates(api_key, base_url: base_url)
+        profiles = Helper::AppscertHelper.fetch_profiles(api_key, base_url: base_url)
+
+        now = Date.today
+        expiring = []
+        expired = []
+
+        (certs + profiles).each do |item|
+          next unless item['expiresAt'] || item['expires_at']
+          expires = Date.parse(item['expiresAt'] || item['expires_at'])
+          days_left = (expires - now).to_i
+          name = item['name'] || item['id']
+
+          if days_left < 0
+            expired << { name: name, days: days_left }
+            UI.error("  ❌ #{name} — EXPIRED #{-days_left} days ago")
+          elsif days_left <= days_threshold
+            expiring << { name: name, days: days_left }
+            UI.important("  ⚠️  #{name} — expires in #{days_left} days")
+          else
+            UI.success("  ✅ #{name} — #{days_left} days remaining")
+          end
+        end
+
+        if expired.any?
+          msg = "#{expired.length} expired certificate(s)/profile(s) found!"
+          fail_on_expiring ? UI.user_error!(msg) : UI.error(msg)
+        elsif expiring.any?
+          msg = "#{expiring.length} item(s) expiring within #{days_threshold} days"
+          fail_on_expiring ? UI.user_error!(msg) : UI.important(msg)
+        else
+          UI.success("✅ All certificates and profiles are healthy!")
+        end
+
+        { expired: expired, expiring: expiring }
+      end
+
+      def self.description
+        "Check if any AppsCert certificates or profiles are expiring soon"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :appscert_api_key, env_name: "APPSCERT_API_KEY", description: "AppsCert API key", optional: true, sensitive: true, type: String),
+          FastlaneCore::ConfigItem.new(key: :api_base_url, env_name: "APPSCERT_API_URL", description: "API base URL", optional: true, type: String),
+          FastlaneCore::ConfigItem.new(key: :days_before_expiry, description: "Warn if expiring within N days", optional: true, default_value: 30, type: Integer),
+          FastlaneCore::ConfigItem.new(key: :fail_on_expiring, description: "Fail the lane if items are expiring", optional: true, default_value: true, is_string: false)
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.category
+        :code_signing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/appscert/actions/appscert_sync.rb

@@ -0,0 +1,61 @@
+module Fastlane
+  module Actions
+    class AppscertSyncAction < Action
+      def self.run(params)
+        api_key = params[:appscert_api_key] || ENV['APPSCERT_API_KEY']
+        UI.user_error!("No AppsCert API key provided. Set appscert_api_key or APPSCERT_API_KEY env var.") unless api_key
+
+        base_url = params[:api_base_url]
+        output_path = params[:output_path] || './appscert'
+        FileUtils.mkdir_p(output_path)
+
+        UI.message("🔄 Syncing certificates from AppsCert...")
+        certs = Helper::AppscertHelper.fetch_certificates(api_key, base_url: base_url)
+        UI.message("Found #{certs.length} certificates")
+
+        certs.each do |cert|
+          file = File.join(output_path, "#{cert['name'] || cert['id']}.p12")
+          Helper::AppscertHelper.download_certificate(api_key, cert['id'], file, base_url: base_url)
+          UI.success("  ✅ #{cert['name']} → #{file}")
+        end
+
+        if params[:include_profiles] != false
+          UI.message("🔄 Syncing profiles...")
+          profiles = Helper::AppscertHelper.fetch_profiles(api_key, base_url: base_url)
+          UI.message("Found #{profiles.length} profiles")
+
+          profiles.each do |profile|
+            file = File.join(output_path, "#{profile['name'] || profile['id']}.mobileprovision")
+            Helper::AppscertHelper.download_profile(api_key, profile['id'], file, base_url: base_url)
+            UI.success("  ✅ #{profile['name']} → #{file}")
+          end
+        end
+
+        UI.success("✅ Sync complete!")
+        output_path
+      end
+
+      def self.description
+        "Sync certificates and provisioning profiles from AppsCert"
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(key: :appscert_api_key, env_name: "APPSCERT_API_KEY", description: "AppsCert API key", optional: true, sensitive: true, type: String),
+          FastlaneCore::ConfigItem.new(key: :api_base_url, env_name: "APPSCERT_API_URL", description: "API base URL (default: https://appscert.com/api)", optional: true, type: String),
+          FastlaneCore::ConfigItem.new(key: :output_path, description: "Directory to save downloaded files", optional: true, default_value: "./appscert", type: String),
+          FastlaneCore::ConfigItem.new(key: :include_profiles, description: "Also sync provisioning profiles", optional: true, default_value: true, is_string: false),
+          FastlaneCore::ConfigItem.new(key: :bundle_id, description: "Filter by bundle ID", optional: true, type: String)
+        ]
+      end
+
+      def self.is_supported?(platform)
+        [:ios, :mac].include?(platform)
+      end
+
+      def self.category
+        :code_signing
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/appscert/helper/appscert_helper.rb

@@ -0,0 +1,51 @@
+require 'faraday'
+require 'json'
+
+module Fastlane
+  module Helper
+    class AppscertHelper
+      BASE_URL = 'https://appscert.com/api'
+
+      def self.api_client(api_key, base_url: nil)
+        url = base_url || ENV['APPSCERT_API_URL'] || BASE_URL
+        Faraday.new(url: url) do |f|
+          f.request :retry, max: 2
+          f.headers['Authorization'] = "Bearer #{api_key}"
+          f.headers['Content-Type'] = 'application/json'
+          f.headers['User-Agent'] = 'fastlane-plugin-appscert/1.0.0'
+          f.adapter Faraday.default_adapter
+        end
+      end
+
+      def self.fetch_certificates(api_key, base_url: nil)
+        client = api_client(api_key, base_url: base_url)
+        response = client.get('/certificates')
+        raise "AppsCert API error: #{response.status}" unless response.status == 200
+        JSON.parse(response.body)
+      end
+
+      def self.fetch_profiles(api_key, base_url: nil)
+        client = api_client(api_key, base_url: base_url)
+        response = client.get('/profiles')
+        raise "AppsCert API error: #{response.status}" unless response.status == 200
+        JSON.parse(response.body)
+      end
+
+      def self.download_certificate(api_key, cert_id, output_path, base_url: nil)
+        client = api_client(api_key, base_url: base_url)
+        response = client.get("/certificates/#{cert_id}/download")
+        raise "Download failed: #{response.status}" unless response.status == 200
+        File.write(output_path, response.body)
+        output_path
+      end
+
+      def self.download_profile(api_key, profile_id, output_path, base_url: nil)
+        client = api_client(api_key, base_url: base_url)
+        response = client.get("/profiles/#{profile_id}/download")
+        raise "Download failed: #{response.status}" unless response.status == 200
+        File.write(output_path, response.body)
+        output_path
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/appscert.rb

@@ -0,0 +1,11 @@
+require 'fastlane/plugin/appscert/actions/appscert_sync'
+require 'fastlane/plugin/appscert/actions/appscert_check'
+require 'fastlane/plugin/appscert/helper/appscert_helper'
+
+module Fastlane
+  module Appscert
+    def self.all_classes
+      Dir[File.expand_path('**/{actions,helper}/*.rb', File.dirname(__FILE__))]
+    end
+  end
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: fastlane-plugin-appscert
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- AppsCert
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-18 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'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  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'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Sync, check, and manage Apple certificates and provisioning profiles
+  via AppsCert API
+email: hello@appscert.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/fastlane/plugin/appscert.rb
+- lib/fastlane/plugin/appscert/actions/appscert_check.rb
+- lib/fastlane/plugin/appscert/actions/appscert_sync.rb
+- lib/fastlane/plugin/appscert/helper/appscert_helper.rb
+homepage: https://appscert.com/docs/fastlane
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Fastlane plugin for AppsCert - Apple certificate management
+test_files: []