optcg-auth-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poneglyph
+
+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.

package/README.md

@@ -0,0 +1,24 @@
+# optcg-auth-client
+
+Typed browser client for the Poneglyph auth service.
+
+```ts
+import { createAuthClient } from "optcg-auth-client";
+
+const auth = createAuthClient();
+await auth.login({ username: "name", password: "password" });
+const session = await auth.getSession();
+await auth.logout();
+```
+
+Requests use `credentials: "include"` so the browser sends and receives the `auth.poneglyph.one` HTTP-only session cookie.
+
+## API
+
+- `buildAuthUrl(path, params?, options?)`
+- `authFetch(path, params?, options?)`
+- `authPost(path, body, options?)`
+- `createAuthClient(options?)`
+- `AuthClientError`
+
+The default auth origin is `https://auth.poneglyph.one`. Pass `baseUrl` to target a local or preview auth service.

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+export declare const DEFAULT_AUTH_BASE_URL = "https://auth.poneglyph.one";
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+export type AuthFetchImplementation = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export type AuthClientOptions = {
+    baseUrl?: string;
+    fetch?: AuthFetchImplementation;
+};
+export type AuthRequestOptions = AuthClientOptions & {
+    signal?: AbortSignal;
+};
+export type AuthUser = {
+    id: string;
+    username: string;
+    display_name: string;
+    email: string | null;
+    email_verified: boolean;
+};
+export type AuthSession = {
+    id: string;
+    expires_at: string;
+};
+export type LoginInput = {
+    username: string;
+    password: string;
+};
+export type RegisterInput = {
+    username: string;
+    password: string;
+    display_name?: string;
+    email?: string | null;
+};
+export type AuthResponse = {
+    data: {
+        user: AuthUser;
+        session: AuthSession;
+        token: string;
+    };
+};
+export type AuthSessionResponse = {
+    data: {
+        user: AuthUser;
+        session: AuthSession;
+    };
+};
+export type LogoutResponse = {
+    data: {
+        ok: true;
+    };
+};
+export declare class AuthClientError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, message: string, body: unknown);
+}
+export declare function buildAuthUrl(path: string, params?: QueryParams, options?: Pick<AuthClientOptions, "baseUrl">): string;
+export declare function authFetch<T>(path: string, params?: QueryParams, options?: AuthRequestOptions): Promise<T>;
+export declare function authPost<T>(path: string, body: unknown, options?: AuthRequestOptions): Promise<T>;
+export declare function createAuthClient(options?: AuthClientOptions): {
+    buildUrl(path: string, params?: QueryParams): string;
+    fetch<T>(path: string, params?: QueryParams, requestOptions?: AuthRequestOptions): Promise<T>;
+    post<T>(path: string, body: unknown, requestOptions?: AuthRequestOptions): Promise<T>;
+    login(input: LoginInput, requestOptions?: AuthRequestOptions): Promise<AuthResponse>;
+    register(input: RegisterInput, requestOptions?: AuthRequestOptions): Promise<AuthResponse>;
+    logout(requestOptions?: AuthRequestOptions): Promise<LogoutResponse>;
+    getSession(requestOptions?: AuthRequestOptions): Promise<AuthSessionResponse>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,108 @@
+export const DEFAULT_AUTH_BASE_URL = "https://auth.poneglyph.one";
+export class AuthClientError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.name = "AuthClientError";
+        this.status = status;
+        this.body = body;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function readStringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value : null;
+}
+function parseJsonText(text) {
+    return JSON.parse(text);
+}
+function extractErrorMessage(body) {
+    if (!isRecord(body))
+        return null;
+    const error = body.error;
+    if (isRecord(error)) {
+        const nestedMessage = readStringField(error, "message");
+        if (nestedMessage)
+            return nestedMessage;
+    }
+    return readStringField(body, "message");
+}
+function resolveFetch(fetchImpl) {
+    if (fetchImpl)
+        return fetchImpl;
+    if (typeof globalThis.fetch === "function") {
+        return globalThis.fetch.bind(globalThis);
+    }
+    throw new Error("No fetch implementation is available");
+}
+async function readJsonBody(response) {
+    const text = await response.text();
+    return (text ? parseJsonText(text) : undefined);
+}
+async function requestJson(url, init, options = {}) {
+    const fetchImpl = resolveFetch(options.fetch);
+    const response = await fetchImpl(url, {
+        ...init,
+        credentials: "include",
+        signal: options.signal,
+    });
+    const body = await readJsonBody(response);
+    if (!response.ok) {
+        throw new AuthClientError(response.status, extractErrorMessage(body) ?? `Auth API error ${response.status}`, body);
+    }
+    return body;
+}
+export function buildAuthUrl(path, params, options = {}) {
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const origin = (options.baseUrl ?? DEFAULT_AUTH_BASE_URL).replace(/\/+$/, "");
+    const url = new URL(`/v1${normalizedPath}`, `${origin}/`);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    return url.toString();
+}
+export async function authFetch(path, params, options = {}) {
+    return requestJson(buildAuthUrl(path, params, options), {}, options);
+}
+export async function authPost(path, body, options = {}) {
+    return requestJson(buildAuthUrl(path, undefined, options), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    }, options);
+}
+export function createAuthClient(options = {}) {
+    return {
+        buildUrl(path, params) {
+            return buildAuthUrl(path, params, options);
+        },
+        fetch(path, params, requestOptions = {}) {
+            return authFetch(path, params, { ...options, ...requestOptions });
+        },
+        post(path, body, requestOptions = {}) {
+            return authPost(path, body, { ...options, ...requestOptions });
+        },
+        login(input, requestOptions = {}) {
+            return authPost("/auth/login", input, { ...options, ...requestOptions });
+        },
+        register(input, requestOptions = {}) {
+            return authPost("/auth/register", input, { ...options, ...requestOptions });
+        },
+        logout(requestOptions = {}) {
+            return authPost("/auth/logout", {}, { ...options, ...requestOptions });
+        },
+        getSession(requestOptions = {}) {
+            return authFetch("/auth/session", undefined, { ...options, ...requestOptions });
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "optcg-auth-client",
+  "version": "0.1.0",
+  "description": "Typed browser client for the Poneglyph auth service",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Reldnahc/optcg-auth-client.git"
+  },
+  "homepage": "https://github.com/Reldnahc/optcg-auth-client#readme",
+  "bugs": {
+    "url": "https://github.com/Reldnahc/optcg-auth-client/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run test",
+    "test": "npm run build && node test/client.test.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.0",
+    "typescript": "^5.9.3"
+  }
+}