taqlyn 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6d583ab227c70a787a0c7df284bb5af6ee135640c1a19661e609621a7c2bb7aa
+  data.tar.gz: 8e46da06d29fd8c6e76593be32376d9261ecd555d85083fadcbc2c51a996277a
+SHA512:
+  metadata.gz: c6ba2debea8fc0f2e2ed9047eb217738a4fb9e683a10e5c679d7c532c0672d6dcf8d9609cb21a313ce8f745eb94f92edd8fdea0bd683da9f7578b67d2ef90cb8
+  data.tar.gz: f12edc7c7289f49b28a83825a29e2e9c148be74092ff19323d5beb72edd7121f6c442bd003bb2e9b94c84991f3f91a534cb427d7281ff5aee7d9c5543bcc5f5b

data/lib/taqlyn/client.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+require_relative "signer"
+
+module Taqlyn
+  class ApiError < StandardError
+    attr_reader :status, :body
+
+    def initialize(status, body)
+      @status = status
+      @body = body
+      super("Taqlyn API #{status}")
+    end
+  end
+
+  class Client
+    DEFAULT_API_BASE_URL = "https://api.taqlyn.com"
+    SHORT_LINKS_PATH = "/v1/short-links"
+
+    def initialize(client_id:, private_key:, base_url: nil, now: nil)
+      raw_url = (base_url && !base_url.to_s.strip.empty?) ? base_url : (ENV["TAQLYN_BASE_URL"] || ENV["TAQLYN_API_URL"] || DEFAULT_API_BASE_URL)
+      raise ArgumentError, "base_url is required" if raw_url.to_s.strip.empty?
+      raise ArgumentError, "client_id is required" if client_id.to_s.strip.empty?
+      unless client_id.start_with?("app_test_", "app_live_")
+        raise ArgumentError, "client_id must start with app_test_ or app_live_"
+      end
+
+      @base_url = raw_url.to_s.sub(%r{/+\z}, "")
+      @client_id = client_id.strip
+      @key = Signer.load_private_key(private_key)
+      @now = now || -> { Time.now.to_i }
+    end
+
+    def create_short_link(destination_web:, mode: nil, destination_path: nil)
+      raise ArgumentError, "destination_web is required" if destination_web.to_s.strip.empty?
+
+      body = { "destinationWeb" => destination_web.strip }
+      body["mode"] = mode if mode
+      body["destinationPath"] = destination_path if destination_path
+      request("POST", SHORT_LINKS_PATH, body)
+    end
+
+    private
+
+    def request(method, path, payload)
+      json = JSON.generate(payload)
+      uri = URI.parse(@base_url + path)
+      headers = Signer.headers(@key, @client_id, method, path, json, @now.call)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      req = Net::HTTP::Post.new(uri.request_uri)
+      req.body = json
+      req["Accept"] = "application/json"
+      req["Content-Type"] = "application/json"
+      headers.each { |k, v| req[k] = v }
+      res = http.request(req)
+      unless res.is_a?(Net::HTTPSuccess)
+        raise ApiError.new(res.code.to_i, res.body)
+      end
+      JSON.parse(res.body)
+    end
+  end
+end

data/lib/taqlyn/signer.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "base64"
+require "digest"
+require "openssl"
+
+module Taqlyn
+  module Signer
+    module_function
+
+    def normalize_pem(pem)
+      value = pem.to_s.strip
+      value = value.gsub('\n', "\n") if value.include?('\n') && !value.include?("\n")
+      value
+    end
+
+    def canonical_message(method, path, unix_timestamp, client_id, body)
+      body_bytes = body.is_a?(String) ? body.b : body.to_s.b
+      [
+        "taqlyn-v1",
+        method.to_s.upcase,
+        path,
+        unix_timestamp.to_s,
+        client_id,
+        Digest::SHA256.hexdigest(body_bytes)
+      ].join("\n")
+    end
+
+    def load_private_key(pem)
+      normalized = normalize_pem(pem)
+      raise ArgumentError, "sk_* is a UX handle only; pass the PKCS#8 PEM" if normalized.start_with?("sk_")
+      raise ArgumentError, "Private key must be a PKCS#8 PEM" unless normalized.include?("BEGIN")
+
+      OpenSSL::PKey.read(normalized)
+    end
+
+    def headers(pkey, client_id, method, path, body, unix_timestamp)
+      message = canonical_message(method, path, unix_timestamp, client_id, body)
+      signature = pkey.sign(nil, message)
+      {
+        "X-Taqlyn-Client-Id" => client_id,
+        "X-Taqlyn-Timestamp" => unix_timestamp.to_s,
+        "X-Taqlyn-Signature" => Base64.strict_encode64(signature)
+      }
+    end
+  end
+end

data/lib/taqlyn.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require_relative "taqlyn/client"
+
+module Taqlyn
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: taqlyn
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Taqlyn
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-12 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/taqlyn.rb
+- lib/taqlyn/client.rb
+- lib/taqlyn/signer.rb
+homepage:
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Taqlyn server SDK — Ed25519-signed short-link API
+test_files: []