Add initial implementation (#1)

Author: silas

.github/workflows/test.yaml

@@ -0,0 +1,43 @@
+name: Test
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths-ignore:
+      - "**.md"
+
+env:
+  CI: "true"
+
+concurrency:
+  group: ${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  sdk:
+    name: SDK
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-version: ["1.20", "1.21"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ matrix.go-version }}
+
+      - name: Check format
+        run: |
+          if [[ -n $( gofmt -l . ) ]]; then
+            gofmt -l .
+            exit 1
+          fi
+
+      - name: Test
+        run: |
+          go test -count=1 ./...

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2024 UserHub, Inc.
+
+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.

README.md

@@ -1 +1,34 @@
 # UserHub Go SDK
+
+Stability: alpha
+
+## Usage
+
+```go
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/userhubdev/go-sdk/adminapi"
+)
+
+func main() {
+	adminApi, err := adminapi.New("sk_123...")
+	if err != nil {
+		panic(err)
+	}
+
+	res, err := adminApi.Users().List(context.TODO(), &adminapi.UserListInput{
+		PageSize: 5,
+	})
+	if err != nil {
+		panic(err)
+	}
+
+	for _, user := range res.Users {
+		fmt.Println(user.Id, user.DisplayName)
+	}
+}
+```

adminapi/adminapi.go

@@ -0,0 +1,52 @@
+// Code generated. DO NOT EDIT.
+
+package adminapi
+
+import (
+	"net/http"
+	"strings"
+
+	"github.com/userhubdev/go-sdk/internal"
+	"github.com/userhubdev/go-sdk/internal/options"
+	"github.com/userhubdev/go-sdk/option"
+	"github.com/userhubdev/go-sdk/types"
+)
+
+type Error = types.UserHubError
+
+// New returns a new Admin API client.
+func New(adminKey string, opts ...option.ClientOption) (Client, error) {
+	o := &options.ClientOptions{
+		BaseUrl: internal.ApiBaseUrl,
+		Headers: http.Header{},
+	}
+	for _, opt := range opts {
+		if opt != nil {
+			opt.Apply(o)
+		}
+	}
+	if err := o.Validate(); err != nil {
+		return nil, err
+	}
+
+	adminKey = strings.TrimSpace(adminKey)
+	if adminKey == "" {
+		return nil, internal.Errorf(nil, nil, "adminKey required")
+	} else if !strings.HasPrefix(adminKey, internal.AdminKeyPrefix) {
+		return nil, internal.Errorf(nil, nil, "adminKey must start with `%s`", internal.AdminKeyPrefix)
+	} else {
+		o.Headers.Set(internal.AuthHeader, "Bearer "+adminKey)
+	}
+
+	transport := internal.NewHttpTransport(o.BaseUrl, o.Headers)
+
+	return newClient(transport), nil
+}
+
+// Some is used to set an Optional value in update methods.
+func Some[T any](v T) types.Optional[T] {
+	return types.Optional[T]{
+		Value:   v,
+		Present: true,
+	}
+}

adminapi/client.go

@@ -0,0 +1,49 @@
+// Code generated. DO NOT EDIT.
+
+package adminapi
+
+import (
+	"github.com/userhubdev/go-sdk/internal"
+)
+
+// The Admin API.
+type Client interface {
+	// The flow methods.
+	Flows() Flows
+	// The invoice methods.
+	Invoices() Invoices
+	// The organization methods.
+	Organizations() Organizations
+	// The subscription methods.
+	Subscriptions() Subscriptions
+	// The user methods.
+	Users() Users
+}
+
+type clientImpl struct {
+	transport internal.Transport
+}
+
+func newClient(transport internal.Transport) Client {
+	return &clientImpl{transport: transport}
+}
+
+func (c *clientImpl) Flows() Flows {
+	return &flowsImpl{transport: c.transport}
+}
+
+func (c *clientImpl) Invoices() Invoices {
+	return &invoicesImpl{transport: c.transport}
+}
+
+func (c *clientImpl) Organizations() Organizations {
+	return &organizationsImpl{transport: c.transport}
+}
+
+func (c *clientImpl) Subscriptions() Subscriptions {
+	return &subscriptionsImpl{transport: c.transport}
+}
+
+func (c *clientImpl) Users() Users {
+	return &usersImpl{transport: c.transport}
+}