@solvapay/core 1.0.0-preview.17 → 1.0.0-preview.19

package/LICENSE.md

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

package/README.md

@@ -3,13 +3,15 @@
 Shared types, schemas, and errors.
 
 ## Install
+
 ```bash
 pnpm add @solvapay/core
 ```
 
 ## Usage
+
 ```ts
-import { SolvaPayError, Env } from '@solvapay/core';
+import { SolvaPayError, Env } from '@solvapay/core'
 ```
 
-More: docs/architecture.md
+More: [docs/guides/architecture.md](../../docs/guides/architecture.md)

package/dist/index.cjs

@@ -32,6 +32,11 @@ var Env = import_zod.z.object({
   SOLVAPAY_API_BASE_URL: import_zod.z.string().url().optional()
 });
 var SolvaPayError = class extends Error {
+  /**
+   * Creates a new SolvaPayError instance.
+   *
+   * @param message - Error message
+   */
   constructor(message) {
     super(message);
     this.name = "SolvaPayError";
@@ -41,7 +46,9 @@ function getSolvaPayConfig() {
   const solvapaySecretKey = process.env.SOLVAPAY_SECRET_KEY;
   const solvapayApiBaseUrl = process.env.SOLVAPAY_API_BASE_URL;
   if (!solvapaySecretKey) {
-    throw new SolvaPayError("Server configuration error: SolvaPay secret key not configured. Missing SOLVAPAY_SECRET_KEY environment variable.");
+    throw new SolvaPayError(
+      "Server configuration error: SolvaPay secret key not configured. Missing SOLVAPAY_SECRET_KEY environment variable."
+    );
   }
   return {
     apiKey: solvapaySecretKey,

package/dist/index.d.cts

@@ -11,7 +11,37 @@ declare const Env: z.ZodObject<{
     SOLVAPAY_API_BASE_URL?: string | undefined;
 }>;
 type Env = z.infer<typeof Env>;
+/**
+ * Base error class for SolvaPay SDK errors.
+ *
+ * All SolvaPay SDK errors extend this class, making it easy to catch
+ * and handle SDK-specific errors separately from other errors.
+ *
+ * @example
+ * ```typescript
+ * import { SolvaPayError } from '@solvapay/core';
+ *
+ * try {
+ *   const config = getSolvaPayConfig();
+ * } catch (error) {
+ *   if (error instanceof SolvaPayError) {
+ *     // Handle SolvaPay-specific error
+ *     console.error('SolvaPay error:', error.message);
+ *   } else {
+ *     // Handle other errors
+ *     throw error;
+ *   }
+ * }
+ * ```
+ *
+ * @since 1.0.0
+ */
 declare class SolvaPayError extends Error {
+    /**
+     * Creates a new SolvaPayError instance.
+     *
+     * @param message - Error message
+     */
     constructor(message: string);
 }
 interface SolvaPayConfig {
@@ -20,10 +50,28 @@ interface SolvaPayConfig {
 }
 /**
  * Validates and returns SolvaPay configuration from environment variables.
- * Throws SolvaPayError if required environment variables are missing.
+ *
+ * Reads `SOLVAPAY_SECRET_KEY` and optional `SOLVAPAY_API_BASE_URL` from
+ * environment variables and returns a validated configuration object.
  *
  * @returns SolvaPayConfig object with apiKey and optional apiBaseUrl
- * @throws SolvaPayError if SOLVAPAY_SECRET_KEY is missing
+ * @throws {SolvaPayError} If SOLVAPAY_SECRET_KEY is missing
+ *
+ * @example
+ * ```typescript
+ * import { getSolvaPayConfig } from '@solvapay/core';
+ *
+ * try {
+ *   const config = getSolvaPayConfig();
+ *   console.log('API Key configured:', config.apiKey);
+ * } catch (error) {
+ *   console.error('Configuration error:', error.message);
+ * }
+ * ```
+ *
+ * @see {@link SolvaPayConfig} for the return type
+ * @see {@link SolvaPayError} for error handling
+ * @since 1.0.0
  */
 declare function getSolvaPayConfig(): SolvaPayConfig;
 declare const version = "0.1.0";

package/dist/index.d.ts

@@ -11,7 +11,37 @@ declare const Env: z.ZodObject<{
     SOLVAPAY_API_BASE_URL?: string | undefined;
 }>;
 type Env = z.infer<typeof Env>;
+/**
+ * Base error class for SolvaPay SDK errors.
+ *
+ * All SolvaPay SDK errors extend this class, making it easy to catch
+ * and handle SDK-specific errors separately from other errors.
+ *
+ * @example
+ * ```typescript
+ * import { SolvaPayError } from '@solvapay/core';
+ *
+ * try {
+ *   const config = getSolvaPayConfig();
+ * } catch (error) {
+ *   if (error instanceof SolvaPayError) {
+ *     // Handle SolvaPay-specific error
+ *     console.error('SolvaPay error:', error.message);
+ *   } else {
+ *     // Handle other errors
+ *     throw error;
+ *   }
+ * }
+ * ```
+ *
+ * @since 1.0.0
+ */
 declare class SolvaPayError extends Error {
+    /**
+     * Creates a new SolvaPayError instance.
+     *
+     * @param message - Error message
+     */
     constructor(message: string);
 }
 interface SolvaPayConfig {
@@ -20,10 +50,28 @@ interface SolvaPayConfig {
 }
 /**
  * Validates and returns SolvaPay configuration from environment variables.
- * Throws SolvaPayError if required environment variables are missing.
+ *
+ * Reads `SOLVAPAY_SECRET_KEY` and optional `SOLVAPAY_API_BASE_URL` from
+ * environment variables and returns a validated configuration object.
  *
  * @returns SolvaPayConfig object with apiKey and optional apiBaseUrl
- * @throws SolvaPayError if SOLVAPAY_SECRET_KEY is missing
+ * @throws {SolvaPayError} If SOLVAPAY_SECRET_KEY is missing
+ *
+ * @example
+ * ```typescript
+ * import { getSolvaPayConfig } from '@solvapay/core';
+ *
+ * try {
+ *   const config = getSolvaPayConfig();
+ *   console.log('API Key configured:', config.apiKey);
+ * } catch (error) {
+ *   console.error('Configuration error:', error.message);
+ * }
+ * ```
+ *
+ * @see {@link SolvaPayConfig} for the return type
+ * @see {@link SolvaPayError} for error handling
+ * @since 1.0.0
  */
 declare function getSolvaPayConfig(): SolvaPayConfig;
 declare const version = "0.1.0";

package/dist/index.js

@@ -5,6 +5,11 @@ var Env = z.object({
   SOLVAPAY_API_BASE_URL: z.string().url().optional()
 });
 var SolvaPayError = class extends Error {
+  /**
+   * Creates a new SolvaPayError instance.
+   *
+   * @param message - Error message
+   */
   constructor(message) {
     super(message);
     this.name = "SolvaPayError";
@@ -14,7 +19,9 @@ function getSolvaPayConfig() {
   const solvapaySecretKey = process.env.SOLVAPAY_SECRET_KEY;
   const solvapayApiBaseUrl = process.env.SOLVAPAY_API_BASE_URL;
   if (!solvapaySecretKey) {
-    throw new SolvaPayError("Server configuration error: SolvaPay secret key not configured. Missing SOLVAPAY_SECRET_KEY environment variable.");
+    throw new SolvaPayError(
+      "Server configuration error: SolvaPay secret key not configured. Missing SOLVAPAY_SECRET_KEY environment variable."
+    );
   }
   return {
     apiKey: solvapaySecretKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/core",
-  "version": "1.0.0-preview.17",
+  "version": "1.0.0-preview.19",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -38,6 +38,7 @@
     "test": "vitest run || exit 0",
     "test:unit": "vitest run || exit 0",
     "test:watch": "vitest",
-    "lint": "echo 'no lint yet'"
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
   }
 }