@vybit/core 1.0.0

package/README.md

@@ -0,0 +1,72 @@
+# @vybit/core
+
+Core utilities and types for Vybit SDKs.
+
+## Overview
+
+This package provides shared utilities, types, and error classes used across all Vybit SDK packages. It includes URL validation, state generation, and common interfaces.
+
+## Installation
+
+```bash
+npm install @vybit/core
+```
+
+## Usage
+
+```typescript
+import { 
+  isValidUrl, 
+  generateRandomState, 
+  getDefaultBaseUrl,
+  getAuthDomain,
+  VybitAuthError 
+} from '@vybit/core';
+
+// Validate URLs
+const isValid = isValidUrl('https://example.com'); // true
+
+// Generate secure random state
+const state = generateRandomState(16); // "abc123def456ghi7"
+
+// Get Vybit endpoints
+const apiUrl = getDefaultBaseUrl(); // "https://vybit.net"
+const authUrl = getAuthDomain(); // "https://app.vybit.net"
+
+// Handle errors
+try {
+  // SDK operation
+} catch (error) {
+  if (error instanceof VybitAuthError) {
+    console.log('Authentication failed:', error.message);
+  }
+}
+```
+
+## API Reference
+
+### Utilities
+
+- `isValidUrl(url: string): boolean` - Validates HTTP/HTTPS URLs
+- `generateRandomState(length?: number): string` - Generates secure random strings
+- `buildQueryString(params: Record<string, string>): string` - Builds URL query strings
+- `getDefaultBaseUrl(): string` - Returns Vybit API base URL
+- `getAuthDomain(): string` - Returns Vybit auth domain
+
+### Error Classes
+
+- `VybitSDKError` - Base error class
+- `VybitAuthError` - Authentication errors
+- `VybitAPIError` - API request errors  
+- `VybitValidationError` - Input validation errors
+
+### Types
+
+- `VybitConfig` - SDK configuration interface
+- `VybitCredentials` - OAuth2 credentials interface
+- `ApiResponse<T>` - Generic API response wrapper
+- `Vybit` - Vybit notification interface
+
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class VybitSDKError extends Error {
+    readonly code: string;
+    readonly details?: any;
+    constructor(message: string, code?: string, details?: any);
+}
+export declare class VybitAuthError extends VybitSDKError {
+    constructor(message: string, details?: any);
+}
+export declare class VybitAPIError extends VybitSDKError {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number, details?: any);
+}
+export declare class VybitValidationError extends VybitSDKError {
+    constructor(message: string, details?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAwB,EAAE,OAAO,CAAC,EAAE,GAAG;CAM3E;AAED,qBAAa,cAAe,SAAQ,aAAa;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAKhE;AAED,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VybitValidationError = exports.VybitAPIError = exports.VybitAuthError = exports.VybitSDKError = void 0;
+class VybitSDKError extends Error {
+    constructor(message, code = 'UNKNOWN_ERROR', details) {
+        super(message);
+        this.name = 'VybitSDKError';
+        this.code = code;
+        this.details = details;
+    }
+}
+exports.VybitSDKError = VybitSDKError;
+class VybitAuthError extends VybitSDKError {
+    constructor(message, details) {
+        super(message, 'AUTH_ERROR', details);
+        this.name = 'VybitAuthError';
+    }
+}
+exports.VybitAuthError = VybitAuthError;
+class VybitAPIError extends VybitSDKError {
+    constructor(message, statusCode, details) {
+        super(message, 'API_ERROR', details);
+        this.name = 'VybitAPIError';
+        this.statusCode = statusCode;
+    }
+}
+exports.VybitAPIError = VybitAPIError;
+class VybitValidationError extends VybitSDKError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.name = 'VybitValidationError';
+    }
+}
+exports.VybitValidationError = VybitValidationError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAc,SAAQ,KAAK;IAItC,YAAY,OAAe,EAAE,OAAe,eAAe,EAAE,OAAa;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAVD,sCAUC;AAED,MAAa,cAAe,SAAQ,aAAa;IAC/C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,MAAa,aAAc,SAAQ,aAAa;IAG9C,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAa;QAC7D,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AARD,sCAQC;AAED,MAAa,oBAAqB,SAAQ,aAAa;IACrD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './utils';
+export * from './errors';
+//# 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":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Core configuration for Vybit SDK
+ */
+export interface VybitConfig {
+    /** Base URL for API calls. Defaults to https://vybit.net */
+    baseUrl?: string;
+}
+/**
+ * OAuth2 credentials for Vybit authentication
+ */
+export interface VybitCredentials {
+    /** OAuth2 client ID from your Vybit app */
+    clientId: string;
+    /** OAuth2 client secret from your Vybit app */
+    clientSecret: string;
+    /** Redirect URI configured in your Vybit app */
+    redirectUri: string;
+}
+/**
+ * Standard error response from Vybit API
+ */
+export interface VybitError {
+    /** Error code identifier */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: any;
+}
+/**
+ * Generic API response wrapper
+ */
+export interface ApiResponse<T = any> {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Response data when successful */
+    data?: T;
+    /** Error information when unsuccessful */
+    error?: VybitError;
+}
+/**
+ * Vybit notification configuration
+ */
+export interface Vybit {
+    /** Display name of the vybit */
+    name: string;
+    /** Unique trigger key for this vybit */
+    triggerKey: string;
+    /** Additional vybit properties */
+    [key: string]: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Validates if a string is a valid HTTP or HTTPS URL
+ * @param url - The URL string to validate
+ * @returns True if the URL is valid and uses HTTP/HTTPS protocol
+ */
+export declare function isValidUrl(url: string): boolean;
+/**
+ * Generates a cryptographically secure random state string for OAuth2
+ * @param length - Length of the generated string (default: 12)
+ * @returns Random alphanumeric string
+ */
+export declare function generateRandomState(length?: number): string;
+/**
+ * Builds a URL query string from an object of parameters
+ * @param params - Object containing key-value pairs for the query string
+ * @returns URL-encoded query string
+ */
+export declare function buildQueryString(params: Record<string, string>): string;
+/**
+ * Gets the default base URL for Vybit API calls
+ * @returns The production API base URL
+ */
+export declare function getDefaultBaseUrl(): string;
+/**
+ * Gets the authentication domain for OAuth2 flows
+ * @returns The production auth domain URL
+ */
+export declare function getAuthDomain(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/utils.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidUrl = isValidUrl;
+exports.generateRandomState = generateRandomState;
+exports.buildQueryString = buildQueryString;
+exports.getDefaultBaseUrl = getDefaultBaseUrl;
+exports.getAuthDomain = getAuthDomain;
+/**
+ * Validates if a string is a valid HTTP or HTTPS URL
+ * @param url - The URL string to validate
+ * @returns True if the URL is valid and uses HTTP/HTTPS protocol
+ */
+function isValidUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generates a cryptographically secure random state string for OAuth2
+ * @param length - Length of the generated string (default: 12)
+ * @returns Random alphanumeric string
+ */
+function generateRandomState(length = 12) {
+    let result = '';
+    while (result.length < length) {
+        result += Math.random().toString(36).substring(2);
+    }
+    return result.substring(0, length);
+}
+/**
+ * Builds a URL query string from an object of parameters
+ * @param params - Object containing key-value pairs for the query string
+ * @returns URL-encoded query string
+ */
+function buildQueryString(params) {
+    return new URLSearchParams(params).toString();
+}
+/**
+ * Gets the default base URL for Vybit API calls
+ * @returns The production API base URL
+ */
+function getDefaultBaseUrl() {
+    return 'https://vybit.net';
+}
+/**
+ * Gets the authentication domain for OAuth2 flows
+ * @returns The production auth domain URL
+ */
+function getAuthDomain() {
+    return 'https://app.vybit.net';
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAKA,gCAOC;AAOD,kDAMC;AAOD,4CAEC;AAMD,8CAEC;AAMD,sCAEC;AAlDD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,SAAiB,EAAE;IACrD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,MAA8B;IAC7D,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa;IAC3B,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@vybit/core",
+  "version": "1.0.0",
+  "description": "Core utilities and types for Vybit SDKs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "jest --config ../../jest.config.js --rootDir ../.."
+  },
+  "keywords": [
+    "vybit",
+    "core",
+    "utilities"
+  ],
+  "author": "Vybit Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vybit/vybit-sdk.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/vybit/vybit-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/vybit/vybit-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}