station 0.0.0 → 0.0.100

data/lib/nexmo_developer/db/migrate/20201016110604_add_details_to_feedback_feedback.rb

@@ -0,0 +1,7 @@
+class AddDetailsToFeedbackFeedback < ActiveRecord::Migration[6.0]
+  def change
+    add_reference :feedback_feedbacks, :feedback_config, null: false, foreign_key: true, type: :uuid, null: true
+    add_column :feedback_feedbacks, :path, :integer
+    add_column :feedback_feedbacks, :steps, :jsonb
+  end
+end

data/lib/nexmo_developer/db/schema.rb

@@ -0,0 +1,152 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `rails
+# db:schema:load`. When creating a new database, `rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema.define(version: 2020_10_16_110604) do
+
+  # These are extensions that must be enabled in order to support this database
+  enable_extension "pgcrypto"
+  enable_extension "plpgsql"
+  enable_extension "uuid-ossp"
+
+  create_table "active_admin_comments", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "namespace"
+    t.text "body"
+    t.string "resource_type"
+    t.uuid "resource_id"
+    t.string "author_type"
+    t.uuid "author_id"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["namespace"], name: "index_active_admin_comments_on_namespace"
+  end
+
+  create_table "events", id: :uuid, default: -> { "uuid_generate_v4()" }, force: :cascade do |t|
+    t.string "title", null: false
+    t.text "description"
+    t.date "starts_at", null: false
+    t.date "ends_at", null: false
+    t.string "url"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.string "city"
+    t.string "country", limit: 2
+    t.float "latitude"
+    t.float "longitude"
+    t.boolean "remote", default: false
+    t.index ["ends_at"], name: "index_events_on_ends_at"
+    t.index ["starts_at"], name: "index_events_on_starts_at"
+  end
+
+  create_table "feedback_authors", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "email"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["email"], name: "index_feedback_authors_on_email"
+  end
+
+  create_table "feedback_configs", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "title"
+    t.jsonb "paths"
+  end
+
+  create_table "feedback_feedbacks", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "sentiment", null: false
+    t.uuid "resource_id", null: false
+    t.uuid "owner_id", null: false
+    t.string "owner_type", null: false
+    t.string "ip", null: false
+    t.text "comment"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.string "code_language"
+    t.boolean "code_language_selected_whilst_on_page"
+    t.boolean "code_language_set_by_url"
+    t.boolean "resolved", default: false, null: false
+    t.uuid "feedback_config_id"
+    t.integer "path"
+    t.jsonb "steps"
+    t.index ["code_language"], name: "index_feedback_feedbacks_on_code_language"
+    t.index ["code_language_selected_whilst_on_page"], name: "index_feedbacks_on_code_language_selected_whilst_on_page"
+    t.index ["code_language_set_by_url"], name: "index_feedbacks_on_code_language_set_by_url"
+    t.index ["feedback_config_id"], name: "index_feedback_feedbacks_on_feedback_config_id"
+    t.index ["ip"], name: "index_feedback_feedbacks_on_ip"
+    t.index ["owner_id", "owner_type"], name: "index_feedback_feedbacks_on_owner_id_and_owner_type"
+    t.index ["resolved"], name: "index_feedback_feedbacks_on_resolved"
+    t.index ["resource_id"], name: "index_feedback_feedbacks_on_resource_id"
+    t.index ["sentiment"], name: "index_feedback_feedbacks_on_sentiment"
+  end
+
+  create_table "feedback_resources", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "uri", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.string "product"
+    t.index ["product"], name: "index_feedback_resources_on_product"
+    t.index ["uri"], name: "index_feedback_resources_on_uri", unique: true
+  end
+
+  create_table "redirects", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "url"
+    t.integer "uses", default: 0
+    t.datetime "created_at", default: "2018-10-23 03:47:51"
+  end
+
+  create_table "sessions", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "title"
+    t.text "description"
+    t.string "author"
+    t.uuid "event_id"
+    t.string "video_url"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.boolean "published"
+    t.index ["published"], name: "index_sessions_on_published"
+  end
+
+  create_table "usage_code_snippet_events", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "language", null: false
+    t.string "snippet", null: false
+    t.string "section", null: false
+    t.string "action", null: false
+    t.string "ip", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["action"], name: "index_usage_code_snippet_events_on_action"
+    t.index ["ip"], name: "index_usage_code_snippet_events_on_ip"
+    t.index ["language"], name: "index_usage_code_snippet_events_on_language"
+    t.index ["snippet"], name: "index_usage_code_snippet_events_on_snippet"
+  end
+
+  create_table "users", id: :uuid, default: -> { "gen_random_uuid()" }, force: :cascade do |t|
+    t.string "email", default: "", null: false
+    t.string "encrypted_password", default: "", null: false
+    t.string "reset_password_token"
+    t.datetime "reset_password_sent_at"
+    t.datetime "remember_created_at"
+    t.integer "sign_in_count", default: 0, null: false
+    t.datetime "current_sign_in_at"
+    t.datetime "last_sign_in_at"
+    t.inet "current_sign_in_ip"
+    t.inet "last_sign_in_ip"
+    t.boolean "admin", default: false, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.string "api_key"
+    t.string "api_secret"
+    t.string "nexmo_developer_api_secret", null: false
+    t.index ["admin"], name: "index_users_on_admin"
+    t.index ["email"], name: "index_users_on_email", unique: true
+    t.index ["reset_password_token"], name: "index_users_on_reset_password_token", unique: true
+  end
+
+  add_foreign_key "feedback_feedbacks", "feedback_configs"
+end

data/lib/nexmo_developer/db/seeds.rb

@@ -0,0 +1,70 @@
+# This file should contain all the record creation needed to seed the database with its default values.
+# The data can then be loaded with the rails db:seed command (or created alongside the database with db:setup).
+#
+# Examples:
+#
+#   movies = Movie.create!([{ name: 'Star Wars' }, { name: 'Lord of the Rings' }])
+#   Character.create!(name: 'Luke', movie: movies.first)
+
+unless Rails.env.test?
+  User.create!(email: 'api.admin@vonage.com', password: 'development', admin: true)
+end
+
+Event.create!({
+  title: 'Small business hackathon',
+  starts_at: Time.zone.parse('2020-03-04'),
+  ends_at: Time.zone.parse('2020-03-05'),
+  url: 'http://www.smallbizhack.com/',
+  description: 'Hack to create new innovations that help small businesses save time so they can get back to their passions',
+  city: 'Mountain View',
+  country: 'US',
+})
+
+Event.create!({
+  title: 'Forward JS',
+  starts_at: Time.zone.parse('2020-03-01'),
+  ends_at: Time.zone.parse('2020-03-01'),
+  url: 'https://forwardjs.com/',
+  description: 'Illuminating lectures, & enlightening workshops',
+  city: 'Ottawa',
+  country: 'CA',
+})
+
+Event.create!({
+  title: 'Render',
+  starts_at: Time.zone.parse('2020-03-30'),
+  ends_at: Time.zone.parse('2020-03-31'),
+  url: 'http://2020.render-conf.com/',
+  description: 'A 2-day conference for front-end developers',
+  city: 'Oxford',
+  country: 'GB',
+})
+
+devrel_con = Event.create!({
+  title: 'DevRelCon London 2016',
+  starts_at: Time.zone.parse('2016-12-07'),
+  ends_at: Time.zone.parse('2016-12-07'),
+  url: 'https://london-2016.devrel.net/',
+  description: 'A one day conference about developer relations, developer experience and developer marketing. December 7th 2016, London.',
+  city: 'London',
+  country: 'GB',
+})
+
+Session.create!({
+  title: 'Introduction to the AAARRRP devrel strategy framework',
+  description: 'Building a DevRel programme is hard. What are the goals of the programme, how do they align with the company goals, what activities should the new Developer Relations team undertake, how do those activities help other departments within the company and how should the success of the team be measured?',
+  author: 'Phil Leggetter',
+  event: devrel_con,
+  video_url: 'https://www.youtube.com/watch?v=i7EZDYYfFmc',
+  published: true,
+})
+
+Session.create!({
+  title: 'How to Proxy Voice Calls on Phones and In-app with the Nexmo Voice API, Kotlin, and WebRTC',
+  description: 'In this coding session, Aaron Bassett creates a traditional PSTN proxy in Kotlin, which he uses to connect two telephone endpoints while keeping both sides of the call anonymous.',
+  author: 'Aaron Bassett',
+  event: devrel_con,
+  video_url: 'https://www.youtube.com/watch?v=pHf9Df3Ns2U',
+  published: true,
+})
+

data/lib/nexmo_developer/docker-compose.yml

@@ -0,0 +1,43 @@
+version: '3'
+services:
+  db:
+    image: postgres
+    environment:
+      - POSTGRES_HOST_AUTH_METHOD=trust
+  web:
+    image: nexmodeveloper_app
+    build: .
+    command: bundle exec rails s -p 3000 -b '0.0.0.0'
+    volumes:
+      - .:/app
+      - /app/node_modules
+    ports:
+      - "3000:3000"
+    depends_on:
+      - clean
+      - update
+      - db
+    environment:
+      - OAS_PATH=_open_api/api_specs/definitions
+      - DOCS_BASE_PATH=.
+      - POSTGRES_HOST=db
+      - POSTGRES_USERNAME=postgres
+      - RAILS_ENV=development
+      - RACK_ENV=development
+  clean:
+    image: nexmodeveloper_app
+    build: .
+    command: bash -c "rm -Rf public/packs && rm -f /app/tmp/pids/server.pid"
+    volumes:
+      - .:/app
+  update:
+    image: nexmodeveloper_app
+    build: .
+    command: bash -c "rake db:setup"
+    volumes:
+      - .:/app
+    depends_on:
+      - db
+    environment:
+      - POSTGRES_HOST=db
+      - POSTGRES_USERNAME=postgres

data/lib/nexmo_developer/lib/common_errors.rb

@@ -0,0 +1,5 @@
+class CommonErrors
+  def self.check_for_migration_error(body)
+    raise 'DB Migration is pending. Please run RAILS_ENV=development bin/rake db:migrate' if body&.downcase&.include?('migrations are pending')
+  end
+end

data/lib/nexmo_developer/lib/tasks/cache.rake

@@ -0,0 +1,6 @@
+namespace :cache do
+  desc "Clear Rails' redis cache"
+  task 'clear': :environment do
+    Rails.cache.clear
+  end
+end

data/lib/nexmo_developer/lib/tasks/careers.rake

@@ -0,0 +1,8 @@
+namespace :careers do
+  desc 'Expire careers cache'
+  task 'expire_cache': :environment do
+    p 'Expiring cache...'
+    Greenhouse.expire_cache
+    p 'Done'
+  end
+end

data/lib/nexmo_developer/lib/tasks/ci.rake

@@ -0,0 +1,171 @@
+require_relative '../common_errors'
+
+namespace :ci do
+  desc 'Verify all pages to make sure that no exceptions are thrown'
+  task 'verify_pages': :environment do
+    document_paths =
+      [
+        "#{Rails.configuration.docs_base_path}/_documentation/en/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_api/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_tutorials/**/*.md",
+      ]
+
+    document_paths.each do |path|
+      Dir.glob(path).each do |filename|
+        document = File.read(filename)
+        begin
+          Nexmo::Markdown::Renderer.new.call(document)
+        rescue StandardError => e
+          puts "Error whilst processing #{filename}"
+          raise e
+        end
+      end
+    end
+  end
+
+  desc 'Verify side navigation to make sure every page has valid YAML metadata'
+  task 'verify_navigation': :environment do
+    session = ActionDispatch::Integration::Session.new(Rails.application)
+    res = session.get '/documentation'
+
+    # Check for migration pending error
+    CommonErrors.check_for_migration_error(session.body)
+
+    raise 'Error rendering documentation index page' if res == 500
+  end
+
+  desc 'Render all OAS based API references'
+  task 'verify_oas_reference': :environment do
+    session = ActionDispatch::Integration::Session.new(Rails.application)
+    OpenApiConstraint.list.each do |name|
+      res = session.get "/api/#{name}"
+
+      # Check for migration pending error
+      CommonErrors.check_for_migration_error(session.body)
+
+      raise "Error rendering /api/#{name} OAS page" if res == 500
+    end
+  end
+
+  desc 'Ensure all OAS error URLS resolve'
+  task 'verify_error_urls_resolve': :environment do
+    session = ActionDispatch::Integration::Session.new(Rails.application)
+    session.host! 'localhost' unless Rails.env.test?
+
+    errors = []
+
+    OpenApiConstraint.list.each do |name|
+      definition = OpenApiDefinitionResolver.find(name)
+
+      definition.endpoints.each do |endpoint|
+        endpoint.responses.each do |response|
+          next if response.code[0] == '2' # Successes don't have error messages
+
+          response.formats.each do |format|
+            schema = response.schema(format)
+
+            # Turn everything in to an array to simplify things
+            if schema['oneOf']
+              properties = schema['oneOf']
+            else
+              properties = [schema['properties']]
+            end
+
+            properties.each do |property|
+              type = property['type']
+
+              # Skip if it's an old-style error
+              next unless type
+
+              # Grab the example URL
+              example = type['example']
+
+              # If it has an example field, and it's a link to NDP
+              if example&.starts_with?('https://developer.nexmo.com/api-errors')
+
+                # Extract the error
+                error = example.split('#')[1]
+
+                # Remove the production prefix
+                path = example.gsub('https://developer.nexmo.com', '')
+
+                # Get the page
+                session.get path
+
+                next if path.include?('/subaccounts')
+
+                # Check for migration pending error
+                CommonErrors.check_for_migration_error(session.body)
+
+                # Make sure it includes the correct ID
+                errors.push({ 'document' => name, 'path' => path }) unless session.response.body.include?("<tr id=\"#{error}\">")
+              end
+            end
+          end
+        end
+      end
+    end
+
+    if errors.length.positive?
+      errors = errors.map do |e|
+        "#{e['path']} (#{e['document']})"
+      end.uniq
+      raise "Missing Errors:\n\n#{errors.join("\n")}"
+    end
+  end
+
+  task 'check_word_blocklist': :environment do
+    markdown_files =
+      [
+        "#{Rails.configuration.docs_base_path}/_documentation/en/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_api/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_tutorials/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_partials/*.md",
+        "#{Rails.configuration.docs_base_path}/_partials/**/*.md",
+        "#{Rails.configuration.docs_base_path}/_modals/**/*.md",
+      ]
+
+    block_list = File.read('.disallowed_words').split("\n")
+
+    errors = []
+    markdown_files.each do |path|
+      Dir.glob(path).each do |filename|
+        block_list.each do |word|
+          word = word.downcase
+          document = File.read(filename).downcase
+          if document.include? word
+            errors.push("#{word} found in #{filename.gsub("#{Rails.configuration.docs_base_path}/", '')}")
+          end
+        end
+      end
+    end
+
+    if errors.length.positive?
+      raise "Blocked words found:\n\n#{errors.join("\n")}"
+    end
+  end
+
+  task 'check_ruby_version': :environment do
+    # We treat .ruby-version as the canonical source
+    ruby_version = File.read('.ruby-version').strip
+
+    # Does our Gemfile match
+    gemfile = File.read('Gemfile.lock')
+    gemfile_version = gemfile.match(/RUBY VERSION.*ruby (\d+\.\d+\.\d+).*BUNDLED WITH/m)[1].strip
+
+    # How about Docker?
+    docker = File.read('Dockerfile')
+    docker_version = docker.match(/FROM ruby:(\d+\.\d+\.\d+).*/)[1].strip
+
+    errors = []
+
+    errors.push("Gemfile.lock (#{gemfile_version}) does not match .ruby-version (#{ruby_version})") if gemfile_version != ruby_version
+    errors.push("Dockerfile (#{docker_version}) does not match .ruby-version (#{ruby_version})") if docker_version != ruby_version
+
+    if errors.length.positive?
+      abort("Ruby version mismatch found:\n\n#{errors.join("\n")}")
+    end
+  end
+
+  task all: %i[verify_pages verify_navigation verify_oas_reference verify_error_urls_resolve check_word_blocklist]
+end