@admiral-io/sdk 0.0.1

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Datalift, LLC.
+
+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,169 @@
+# admiral-ts
+
+TypeScript client library for the Admiral API.
+
+## Installation
+
+```bash
+npm install @admiral-io/sdk
+```
+
+## Usage
+
+```typescript
+import { createClient } from "@admiral-io/sdk";
+
+const client = createClient({
+  baseUrl: "https://api.admiral.io",
+  authToken: "your-token-here",
+});
+
+// Access services via properties
+// await client.healthcheck.methodName({ ... });
+// await client.user.methodName({ ... });
+```
+
+## Available Services
+
+| Service | Property | Description |
+|---------|----------|-------------|
+| HealthcheckAPI | `client.healthcheck` | Healthcheck service |
+| UserAPI | `client.user` | User service |
+
+## Example
+
+```typescript
+import { createClient } from "@admiral-io/sdk";
+
+async function main() {
+  const client = createClient({
+    baseUrl: "https://api.admiral.io",
+    authToken: process.env.ADMIRAL_TOKEN,
+  });
+
+  // Validate token before making requests
+  const validation = client.validateToken();
+  if (!validation.valid) {
+    throw new Error(`Invalid token: ${validation.error}`);
+  }
+
+  // Call a service method
+  try {
+    const response = await client.healthcheck.listMethod({});
+    console.log(response);
+  } catch (err) {
+    console.error("Request failed:", err);
+  }
+}
+
+main();
+```
+
+## Configuration
+
+```typescript
+import { createClient, type ClientConfig } from "@admiral-io/sdk";
+
+const config: ClientConfig = {
+  // Base URL for the API server
+  baseUrl: "https://api.admiral.io",
+
+  // Authentication token (JWT)
+  authToken: "your-jwt-token",
+
+  // Request timeout in milliseconds (default: 30000)
+  timeout: 30000,
+
+  // HTTP version: "1.1" or "2" (default: "2")
+  httpVersion: "2",
+
+  // Custom headers to include in all requests
+  headers: {
+    "X-Custom-Header": "value",
+  },
+};
+
+const client = createClient(config);
+```
+
+## Token Validation
+
+```typescript
+// Validate token format and expiration
+const validation = client.validateToken();
+if (!validation.valid) {
+  console.error("Invalid token:", validation.error);
+}
+
+// Get detailed token information
+const info = client.getTokenInfo();
+if (info) {
+  console.log("Subject:", info.claims.sub);
+  console.log("Expired:", info.isExpired);
+  console.log("Expires in:", info.expiresIn, "ms");
+}
+```
+
+## Token Utilities
+
+Standalone functions for working with JWT tokens:
+
+```typescript
+import {
+  parseJWTToken,
+  validateAuthToken,
+  isTokenExpired,
+  isTokenNotYetValid,
+  tokenExpiresIn,
+  getTokenInfo,
+} from "@admiral-io/sdk";
+
+// Parse JWT claims without validation
+const claims = parseJWTToken(token);
+console.log("Subject:", claims.sub);
+console.log("Issuer:", claims.iss);
+
+// Validate token format and timing
+const result = validateAuthToken(token);
+if (!result.valid) {
+  console.error(result.error);
+}
+
+// Check expiration status
+if (isTokenExpired(claims)) {
+  console.log("Token has expired");
+}
+
+// Check if token is not yet valid (nbf claim)
+if (isTokenNotYetValid(claims)) {
+  console.log("Token not yet valid");
+}
+
+// Get milliseconds until expiration
+const expiresIn = tokenExpiresIn(claims);
+console.log("Expires in:", expiresIn, "ms");
+```
+
+## Advanced: Direct Transport Access
+
+For advanced use cases, you can access the underlying Connect transport:
+
+```typescript
+import { createClient } from "@admiral-io/sdk";
+import { createClient as createConnectClient } from "@connectrpc/connect";
+import { SomeOtherService } from "./custom-service_pb";
+
+const client = createClient({ ... });
+
+// Use the transport directly with other services
+const customClient = createConnectClient(SomeOtherService, client.transport);
+```
+
+## Requirements
+
+- Node.js >= 22
+- ESM only (no CommonJS support)
+
+## License
+
+MIT License - see [LICENSE](LICENSE.txt) for details.

package/dist/client/client.d.ts

@@ -0,0 +1,58 @@
+import type { Transport, Client as ConnectClient } from "@connectrpc/connect";
+import type { ClientConfig } from "./lib/config.js";
+import { type JWTClaims } from "./lib/auth.js";
+import { HealthcheckAPI } from "../proto/healthcheck/v1/healthcheck_pb.js";
+import { UserAPI } from "../proto/user/v1/user_pb.js";
+type HealthcheckClient = ConnectClient<typeof HealthcheckAPI>;
+type UserClient = ConnectClient<typeof UserAPI>;
+/**
+ * Admiral client interface.
+ */
+export interface Client {
+    /** The underlying Connect transport */
+    readonly transport: Transport;
+    /** Healthcheck service client */
+    readonly healthcheck: HealthcheckClient;
+    /** User service client */
+    readonly user: UserClient;
+    /**
+     * Validates the current auth token.
+     * @returns Token validation result
+     */
+    validateToken(): {
+        valid: boolean;
+        error?: string;
+        claims?: JWTClaims;
+    };
+    /**
+     * Gets information about the current auth token.
+     * @returns Token claims and expiration info
+     */
+    getTokenInfo(): {
+        claims: JWTClaims;
+        isExpired: boolean;
+        expiresIn: number;
+    } | null;
+}
+/**
+ * Creates a new Admiral API client.
+ *
+ * @param config - Client configuration
+ * @returns Client instance with service accessors
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from "@admiral-io/sdk";
+ *
+ * const client = createClient({
+ *   baseUrl: "https://api.admiral.io",
+ *   authToken: "your-token-here",
+ * });
+ *
+ * // Access services via properties
+ * const resp = await client.healthcheck.healthcheckMethod({});
+ * ```
+ */
+export declare function createClient(config: ClientConfig): Client;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../client/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGtD,KAAK,iBAAiB,GAAG,aAAa,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,KAAK,UAAU,GAAG,aAAa,CAAC,OAAO,OAAO,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAExC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;;OAGG;IACH,aAAa,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAExE;;;OAGG;IACH,YAAY,IAAI;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0CzD"}

package/dist/client/client.js

@@ -0,0 +1,63 @@
+import { createClient as createConnectClient } from "@connectrpc/connect";
+import { createTransport } from "./lib/transport.js";
+import { validateAuthToken, getTokenInfo } from "./lib/auth.js";
+import { HealthcheckAPI } from "../proto/healthcheck/v1/healthcheck_pb.js";
+import { UserAPI } from "../proto/user/v1/user_pb.js";
+/**
+ * Creates a new Admiral API client.
+ *
+ * @param config - Client configuration
+ * @returns Client instance with service accessors
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from "@admiral-io/sdk";
+ *
+ * const client = createClient({
+ *   baseUrl: "https://api.admiral.io",
+ *   authToken: "your-token-here",
+ * });
+ *
+ * // Access services via properties
+ * const resp = await client.healthcheck.healthcheckMethod({});
+ * ```
+ */
+export function createClient(config) {
+    const transport = createTransport(config);
+    // Lazily initialized service clients
+    let _healthcheck;
+    let _user;
+    return {
+        transport,
+        get healthcheck() {
+            if (!_healthcheck) {
+                _healthcheck = createConnectClient(HealthcheckAPI, transport);
+            }
+            return _healthcheck;
+        },
+        get user() {
+            if (!_user) {
+                _user = createConnectClient(UserAPI, transport);
+            }
+            return _user;
+        },
+        validateToken() {
+            if (!config.authToken) {
+                return { valid: false, error: "No auth token configured" };
+            }
+            return validateAuthToken(config.authToken);
+        },
+        getTokenInfo() {
+            if (!config.authToken) {
+                return null;
+            }
+            try {
+                return getTokenInfo(config.authToken);
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../client/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAkB,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAgCtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE1C,qCAAqC;IACrC,IAAI,YAA2C,CAAC;IAChD,IAAI,KAA6B,CAAC;IAElC,OAAO;QACL,SAAS;QAET,IAAI,WAAW;YACb,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,YAAY,GAAG,mBAAmB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IAAI,IAAI;YACN,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,aAAa;YACX,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;YAC7D,CAAC;YACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,YAAY;YACV,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { createClient, type Client } from "./client.js";
+export { type ClientConfig, DEFAULT_CONFIG, resolveConfig } from "./lib/config.js";
+export { type JWTClaims, type TokenValidation, parseJWTToken, validateAuthToken, isTokenExpired, isTokenNotYetValid, tokenExpiresIn, getTokenInfo, } from "./lib/auth.js";
+export { createTransport } from "./lib/transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGnF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,9 @@
+// Client
+export { createClient } from "./client.js";
+// Configuration
+export { DEFAULT_CONFIG, resolveConfig } from "./lib/config.js";
+// Token utilities
+export { parseJWTToken, validateAuthToken, isTokenExpired, isTokenNotYetValid, tokenExpiresIn, getTokenInfo, } from "./lib/auth.js";
+// Transport (for advanced use cases)
+export { createTransport } from "./lib/transport.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAExD,gBAAgB;AAChB,OAAO,EAAqB,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnF,kBAAkB;AAClB,OAAO,EAGL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,qCAAqC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/lib/auth.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Standard JWT claims.
+ */
+export interface JWTClaims {
+    /** Issuer */
+    iss?: string;
+    /** Subject */
+    sub?: string;
+    /** Audience */
+    aud?: string | string[];
+    /** Expiration time (Unix timestamp) */
+    exp?: number;
+    /** Not before (Unix timestamp) */
+    nbf?: number;
+    /** Issued at (Unix timestamp) */
+    iat?: number;
+    /** JWT ID */
+    jti?: string;
+}
+/**
+ * Token validation result.
+ */
+export interface TokenValidation {
+    valid: boolean;
+    error?: string;
+    claims?: JWTClaims;
+}
+/**
+ * Parses a JWT token and extracts claims without validating the signature.
+ * This is sufficient for basic format validation and expiration checking.
+ */
+export declare function parseJWTToken(token: string): JWTClaims;
+/**
+ * Checks if the token is expired based on the exp claim.
+ */
+export declare function isTokenExpired(claims: JWTClaims): boolean;
+/**
+ * Checks if the token is not yet valid based on the nbf claim.
+ */
+export declare function isTokenNotYetValid(claims: JWTClaims): boolean;
+/**
+ * Returns the duration in milliseconds until the token expires.
+ */
+export declare function tokenExpiresIn(claims: JWTClaims): number;
+/**
+ * Validates the format and expiration of an auth token.
+ * Assumes the token is a JWT but gracefully handles non-JWT tokens.
+ */
+export declare function validateAuthToken(token: string): TokenValidation;
+/**
+ * Gets token info including claims and expiration status.
+ */
+export declare function getTokenInfo(token: string): {
+    claims: JWTClaims;
+    isExpired: boolean;
+    expiresIn: number;
+};
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../client/lib/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAkBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAiBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAKzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAK7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAKxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAqChE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CASA"}

package/dist/client/lib/auth.js

@@ -0,0 +1,111 @@
+/**
+ * Decodes a base64url string.
+ */
+function base64UrlDecode(input) {
+    // Replace base64url characters with base64 characters
+    let base64 = input.replace(/-/g, "+").replace(/_/g, "/");
+    // Add padding if necessary
+    const padding = base64.length % 4;
+    if (padding) {
+        base64 += "=".repeat(4 - padding);
+    }
+    return Buffer.from(base64, "base64").toString("utf-8");
+}
+/**
+ * Parses a JWT token and extracts claims without validating the signature.
+ * This is sufficient for basic format validation and expiration checking.
+ */
+export function parseJWTToken(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3) {
+        throw new Error(`Invalid token format: expected 3 parts, got ${parts.length}`);
+    }
+    const payload = parts[1];
+    if (!payload) {
+        throw new Error("Invalid token format: missing payload");
+    }
+    try {
+        const decoded = base64UrlDecode(payload);
+        return JSON.parse(decoded);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse token payload: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Checks if the token is expired based on the exp claim.
+ */
+export function isTokenExpired(claims) {
+    if (!claims.exp) {
+        return false; // No expiration set
+    }
+    return Date.now() >= claims.exp * 1000;
+}
+/**
+ * Checks if the token is not yet valid based on the nbf claim.
+ */
+export function isTokenNotYetValid(claims) {
+    if (!claims.nbf) {
+        return false; // No nbf claim set
+    }
+    return Date.now() < claims.nbf * 1000;
+}
+/**
+ * Returns the duration in milliseconds until the token expires.
+ */
+export function tokenExpiresIn(claims) {
+    if (!claims.exp) {
+        return 0; // No expiration
+    }
+    return claims.exp * 1000 - Date.now();
+}
+/**
+ * Validates the format and expiration of an auth token.
+ * Assumes the token is a JWT but gracefully handles non-JWT tokens.
+ */
+export function validateAuthToken(token) {
+    if (!token) {
+        return { valid: false, error: "Auth token is empty" };
+    }
+    // Remove Bearer prefix if present
+    const actualToken = token.replace(/^Bearer\s+/i, "");
+    // If it doesn't look like a JWT (no dots), treat it as an opaque token
+    if (!actualToken.includes(".")) {
+        if (actualToken.length < 10) {
+            return { valid: false, error: `Token appears too short (length: ${actualToken.length})` };
+        }
+        return { valid: true }; // Assume opaque token is valid
+    }
+    // Parse as JWT
+    let claims;
+    try {
+        claims = parseJWTToken(actualToken);
+    }
+    catch (err) {
+        return { valid: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    // Check if token is expired
+    if (isTokenExpired(claims)) {
+        const expDate = claims.exp ? new Date(claims.exp * 1000).toISOString() : "unknown";
+        return { valid: false, error: `Token expired at ${expDate}`, claims };
+    }
+    // Check if token is not yet valid
+    if (isTokenNotYetValid(claims)) {
+        const nbfDate = claims.nbf ? new Date(claims.nbf * 1000).toISOString() : "unknown";
+        return { valid: false, error: `Token not yet valid until ${nbfDate}`, claims };
+    }
+    return { valid: true, claims };
+}
+/**
+ * Gets token info including claims and expiration status.
+ */
+export function getTokenInfo(token) {
+    const actualToken = token.replace(/^Bearer\s+/i, "");
+    const claims = parseJWTToken(actualToken);
+    return {
+        claims,
+        isExpired: isTokenExpired(claims),
+        expiresIn: tokenExpiresIn(claims),
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/lib/auth.js.map

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

package/dist/client/lib/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Client configuration options.
+ */
+export interface ClientConfig {
+    /**
+     * Base URL for the API server.
+     * @default "https://api.admiral.io"
+     * @example "https://api.admiral.io"
+     */
+    baseUrl?: string;
+    /**
+     * Authentication token (JWT or opaque token).
+     */
+    authToken?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * HTTP version to use.
+     * @default "2"
+     */
+    httpVersion?: "1.1" | "2";
+    /**
+     * Custom headers to include in all requests.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_CONFIG: {
+    readonly baseUrl: "https://api.admiral.io";
+    readonly timeout: 30000;
+    readonly httpVersion: "2";
+};
+/**
+ * Validates and applies defaults to the configuration.
+ */
+export declare function resolveConfig(config: ClientConfig): Required<Omit<ClientConfig, "authToken" | "headers">> & Pick<ClientConfig, "authToken" | "headers">;
+//# sourceMappingURL=config.d.ts.map

package/dist/client/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../client/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC,CAiBvJ"}

package/dist/client/lib/config.js

@@ -0,0 +1,29 @@
+/**
+ * Default configuration values.
+ */
+export const DEFAULT_CONFIG = {
+    baseUrl: "https://api.admiral.io",
+    timeout: 30000,
+    httpVersion: "2",
+};
+/**
+ * Validates and applies defaults to the configuration.
+ */
+export function resolveConfig(config) {
+    const baseUrl = config.baseUrl ?? DEFAULT_CONFIG.baseUrl;
+    // Validate URL format
+    try {
+        new URL(baseUrl);
+    }
+    catch {
+        throw new Error(`Invalid baseUrl: ${baseUrl}`);
+    }
+    return {
+        baseUrl: baseUrl.replace(/\/$/, ""), // Remove trailing slash
+        authToken: config.authToken,
+        timeout: config.timeout ?? DEFAULT_CONFIG.timeout,
+        httpVersion: config.httpVersion ?? DEFAULT_CONFIG.httpVersion,
+        headers: config.headers,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/client/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../client/lib/config.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,wBAAwB;IACjC,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,GAAY;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC;IAEzD,sBAAsB;IACtB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,wBAAwB;QAC7D,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;QACjD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;QAC7D,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/client/lib/transport.d.ts

@@ -0,0 +1,7 @@
+import type { Transport } from "@connectrpc/connect";
+import type { ClientConfig } from "./config.js";
+/**
+ * Creates a Connect transport with the provided configuration.
+ */
+export declare function createTransport(config: ClientConfig): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/client/lib/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../client/lib/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8ChD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAuB/D"}