triauth 0.0.1 → 1.0.0.beta.4

data/lib/triauth/version.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2026 The Triauth Authors (https://www.triauth.org/)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+
+module Triauth
+  # The gem version (RubyGems prerelease syntax for triauth-js 1.0.0-beta.4); the protocol version lives in `Triauth::Protocol::VERSION`.
+  VERSION = '1.0.0.beta.4'
+end

data/lib/triauth.rb

@@ -1,14 +1,111 @@
 # frozen_string_literal: true
 
-# Official placeholder for the triauth project. See https://www.triauth.org/.
+# Copyright (c) 2026 The Triauth Authors (https://www.triauth.org/)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+
+require_relative 'triauth/version'
+require_relative 'triauth/protocol'
+require_relative 'triauth/config'
+require_relative 'triauth/error'
+require_relative 'triauth/logger'
+require_relative 'triauth/helpers'
+require_relative 'triauth/verifiers'
+require_relative 'triauth/resolvers'
+require_relative 'triauth/validator'
+require_relative 'triauth/authentication_endpoint'
+require_relative 'triauth/identity_domain'
+require_relative 'triauth/identity_keys'
+require_relative 'triauth/identity_includes'
+require_relative 'triauth/identity'
+require_relative 'triauth/signature'
+require_relative 'triauth/multi_signature'
+require_relative 'triauth/challenge'
+require_relative 'triauth/response'
+require_relative 'triauth/response_cipher'
+require_relative 'triauth/request_cipher'
+require_relative 'triauth/challenge_response_flow'
+require_relative 'triauth/api'
+
+# Entry point of triauth-ruby, assembling the `Triauth` namespace.
+#
+# Example use:
+#
+# ```ruby
+# require 'triauth'
+# Triauth.authenticate(...)
+# ```
 module Triauth
-  VERSION = "0.0.1"
+  # Top-level classes and namespaces
+  # (the `export` lines have no counterpart: `Helpers`, `Logger`, `Validator`, `Error`, `Identity`, `IdentityKeys`,
+  # `IdentityIncludes`, `IdentityDomain`, `AuthenticationEndpoint`, `Challenge`, `Response`, `Signature`, `MultiSignature`,
+  # `ChallengeResponseFlow`, `Triauth.config`, `Resolvers`, `Verifiers` and `Api` are defined on this module by the files required above)
+
+  # `index.js` re-exports `LIMITS` of `protocol.js` at the top level; so does the port.
+  LIMITS = Protocol::LIMITS
+
+  # Top-level API method aliases
+  class << self
+    # (see ::Triauth::Api::Authentication.authenticate)
+    # (`options = {}`: a missing argument is the JS `undefined`, which `ChallengeResponseFlow.perform`'s own default turns into `{}` (`invalid_arguments` from the stage detection); an explicit nil is the JS `null` (`invalid_arguments` from the known-keys guard))
+    def authenticate(options = {}, config = {}) = Api::Authentication.authenticate(options, config)
+
+    # (see ::Triauth::Api::Authentication.check)
+    def check(options = nil, config = {}) = Api::Authentication.check(options, config)
+
+    # (see ::Triauth::Api::Authentication.ping)
+    # (`options = {}`: as for `authenticate`)
+    def ping(options = {}, config = {}) = Api::Authentication.ping(options, config)
+
+    # (see ::Triauth::Api::Attestation.attest)
+    def attest(options = nil, config = {}) = Api::Attestation.attest(options, config)
+
+    # (see ::Triauth::Api::Identity.whois)
+    def whois(options = nil, config = {}) = Api::Identity.whois(options, config)
+
+    # (see ::Triauth::Api::Validation.validate)
+    def validate(objects = nil, config = {}) = Api::Validation.validate(objects, config)
+
+    # (see ::Triauth::Api::Signing.sign)
+    def sign(options = nil, config = {}) = Api::Signing.sign(options, config)
+
+    # (see ::Triauth::Api::Signing.stamp)
+    def stamp(options = nil, config = {}) = Api::Signing.stamp(options, config)
+
+    # (see ::Triauth::Api::Signing.verify)
+    def verify(message = nil, signature = nil, constraints = {}, config = {}) = Api::Signing.verify(message, signature, constraints, config)
+  end
+
+  # Initialize defaults that depend on constructed instances
 
-  MESSAGE = "triauth for Ruby has not been released yet.\n" \
-            "This package name is reserved by the triauth project to prevent supply-chain confusion.\n" \
-            "See https://www.triauth.org/"
+  # `config.logger ??= ...`: assign only when nullish
+  config[:logger] = Logger.new(Logger::CONSOLE, { logLevel: 'error', prefix: '[triauth]' }) if config[:logger].nil?
 
-  def self.method_missing(*) = raise(NotImplementedError, MESSAGE)
+  # `config.resolver ??= ...`: assign only when nullish (`4e3` and `8.5e3` are these Integers; `NodeDns` is `SystemDns`)
+  if config[:resolver].nil?
+    config[:resolver] = Resolvers::MultiResolver.new(
+      [
+        Resolvers::Cloudflare.new({ retries: 1, timeout: 4000 }),
+        Resolvers::Google.new({ retries: 1, timeout: 4000 }),
+        Resolvers::SystemDns.new({ timeout: 4000 })
+      ],
+      { maxFailures: 1, timeout: 8500 }
+    )
+  end
 
-  def self.respond_to_missing?(*) = true
+  # Web browser specific - dispatch a `triauth:ready` event when loaded
+  # (dropped: the `typeof window` browser lane has no counterpart in a server-side Ruby gem)
 end

metadata

@@ -1,34 +1,77 @@
 --- !ruby/object:Gem::Specification
 name: triauth
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0.beta.4
 platform: ruby
 authors:
-- Triauth
-autorequire:
+- The Triauth Authors
 bindir: bin
 cert_chain: []
-date: 2026-06-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: 'triauth: password-less sign-in for web. Placeholder - real release coming;
-  see https://www.triauth.org/'
+description: Authentication for modern web - a client library for the triauth protocol.
+  triauth-ruby is a faithful port of triauth-js, the reference implementation, and
+  shares its JSON conformance suites.
 email:
-- devs@triauth.org
+- security@triauth.org
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/triauth.rb
+- lib/triauth/api.rb
+- lib/triauth/api/attestation.rb
+- lib/triauth/api/authentication.rb
+- lib/triauth/api/identity.rb
+- lib/triauth/api/signing.rb
+- lib/triauth/api/validation.rb
+- lib/triauth/authentication_endpoint.rb
+- lib/triauth/challenge.rb
+- lib/triauth/challenge_response_flow.rb
+- lib/triauth/config.rb
+- lib/triauth/error.rb
+- lib/triauth/helpers.rb
+- lib/triauth/identity.rb
+- lib/triauth/identity_domain.rb
+- lib/triauth/identity_includes.rb
+- lib/triauth/identity_keys.rb
+- lib/triauth/logger.rb
+- lib/triauth/multi_signature.rb
+- lib/triauth/protocol.rb
+- lib/triauth/request_cipher.rb
+- lib/triauth/resolvers.rb
+- lib/triauth/resolvers/base.rb
+- lib/triauth/resolvers/caching_resolver.rb
+- lib/triauth/resolvers/cloudflare.rb
+- lib/triauth/resolvers/dns_json.rb
+- lib/triauth/resolvers/dns_sb.rb
+- lib/triauth/resolvers/google.rb
+- lib/triauth/resolvers/multi_resolver.rb
+- lib/triauth/resolvers/system_dns.rb
+- lib/triauth/response.rb
+- lib/triauth/response_cipher.rb
+- lib/triauth/signature.rb
+- lib/triauth/validator.rb
+- lib/triauth/verifiers.rb
+- lib/triauth/verifiers/base.rb
+- lib/triauth/verifiers/ecdsa.rb
+- lib/triauth/verifiers/ed25519.rb
+- lib/triauth/verifiers/registry.rb
+- lib/triauth/verifiers/web_authn.rb
+- lib/triauth/version.rb
 homepage: https://www.triauth.org/
 licenses:
-- BSD-3-Clause
+- Apache-2.0
 metadata:
   homepage_uri: https://www.triauth.org/
   source_code_uri: https://github.com/triauth/triauth-ruby
+  changelog_uri: https://github.com/triauth/triauth-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/triauth/triauth-ruby/issues
+  documentation_uri: https://rubydoc.info/gems/triauth
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -36,15 +79,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
-summary: 'triauth: password-less sign-in for web (placeholder)'
+summary: Authentication for modern web - a client library for the triauth protocol.
 test_files: []