@glideidentity/glide-be-sdk-node 2.0.1

package/LICENSE

@@ -0,0 +1,4 @@
+Copyright (c) Glide Identity Inc.
+
+Use of this SDK is permitted solely to enable your use of Glide Identity Inc.'s
+services. All other use of this SDK is prohibited. All other rights are reserved.

package/README.md

@@ -0,0 +1,90 @@
+# @glideidentity/glide-be-sdk-node
+
+Glide SDK for Node.js — carrier-based phone verification.
+
+**Documentation**: https://docs.glideidentity.com
+
+## Installation
+
+```bash
+npm install @glideidentity/glide-be-sdk-node
+```
+
+## Quick Start
+
+```typescript
+import { GlideClient, UseCase } from '@glideidentity/glide-be-sdk-node';
+
+const client = new GlideClient({
+    clientId: process.env.GLIDE_CLIENT_ID,
+    clientSecret: process.env.GLIDE_CLIENT_SECRET
+});
+
+// Prepare authentication
+const response = await client.magicalAuth.prepare({
+    use_case: UseCase.VERIFY_PHONE_NUMBER,
+    phone_number: '+14155551234'
+});
+
+// Process credential from browser
+const result = await client.magicalAuth.verifyPhoneNumber({
+    session: response.session,
+    credential: credentialFromBrowser
+});
+
+console.log(result.verified); // true
+```
+
+## Configuration
+
+```typescript
+const client = new GlideClient({
+    clientId: 'your-client-id',       // Required (or set GLIDE_CLIENT_ID env var)
+    clientSecret: 'your-secret',      // Required (or set GLIDE_CLIENT_SECRET env var)
+    baseUrl: 'https://api.glideidentity.app', // Optional, defaults to production
+    logLevel: LogLevel.INFO,          // DEBUG | INFO | WARN | ERROR
+    logFormat: 'text',                // 'text' | 'json'
+    tokenRefreshBuffer: 60,           // Seconds before token expiry to refresh (default: 60)
+});
+```
+
+### Environment Variables
+
+Configuration can also be set via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `GLIDE_CLIENT_ID` | — | OAuth2 client ID (required if not set programmatically) |
+| `GLIDE_CLIENT_SECRET` | — | OAuth2 client secret (required if not set programmatically) |
+| `GLIDE_API_BASE_URL` | `https://api.glideidentity.app` | API endpoint |
+| `GLIDE_LOG_LEVEL` | `info` | Log level: debug, info, warn, error |
+
+Programmatic settings take precedence over environment variables.
+
+## Error Handling
+
+```typescript
+import { MagicalAuthError, ErrorCode } from '@glideidentity/glide-be-sdk-node';
+
+try {
+    await client.magicalAuth.prepare(request);
+} catch (error) {
+    if (error instanceof MagicalAuthError) {
+        if (error.is(ErrorCode.CARRIER_NOT_ELIGIBLE)) {
+            // Handle unsupported carrier
+        }
+    }
+}
+```
+
+## Types Only
+
+For types and constants without HTTP client:
+
+```bash
+npm install @glideidentity/glide-be-sdk-node-core
+```
+
+## License
+
+Copyright (c) Glide Identity Inc.

package/dist/errors.d.ts

@@ -0,0 +1,58 @@
+import { ErrorCode } from '@glideidentity/glide-be-sdk-node-core';
+import type { ErrorCodeType } from '@glideidentity/glide-be-sdk-node-core';
+export { ErrorCode };
+export type { ErrorCodeType };
+/**
+ * Error thrown by Magical Auth operations.
+ *
+ * @example
+ * try {
+ *     await client.magicalAuth.prepare(request);
+ * } catch (error) {
+ *     if (error instanceof MagicalAuthError) {
+ *         console.log(error.code, error.status);
+ *     }
+ * }
+ */
+export declare class MagicalAuthError extends Error {
+    readonly name = "MagicalAuthError";
+    /** Error code (e.g., CARRIER_NOT_ELIGIBLE). */
+    readonly code: string;
+    /** HTTP status code. */
+    readonly status: number;
+    /** Request ID for debugging. */
+    readonly requestId?: string;
+    readonly timestamp?: string;
+    readonly traceId?: string;
+    readonly spanId?: string;
+    readonly service?: string;
+    readonly details?: Record<string, unknown>;
+    constructor(errorResponse: {
+        code?: string;
+        message?: string;
+        status?: number;
+        request_id?: string;
+        requestId?: string;
+        timestamp?: string;
+        trace_id?: string;
+        traceId?: string;
+        span_id?: string;
+        spanId?: string;
+        service?: string;
+        details?: Record<string, unknown>;
+    });
+    /** Checks if error matches the specified code. */
+    is(code: ErrorCodeType): boolean;
+    toJSON(): {
+        code: string;
+        message: string;
+        status: number;
+        request_id: string | undefined;
+        timestamp: string | undefined;
+        trace_id: string | undefined;
+        span_id: string | undefined;
+        service: string | undefined;
+        details: Record<string, unknown> | undefined;
+    };
+}
+//# 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,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACvC,SAAgB,IAAI,sBAAsB;IAC1C,+CAA+C;IAC/C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,wBAAwB;IACxB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,gCAAgC;IAChC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,aAAa,EAAE;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC;IAsBD,kDAAkD;IAClD,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO;IAIhC,MAAM;;;;;;;;;;;CAqBT"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MagicalAuthError = exports.ErrorCode = void 0;
+const glide_be_sdk_node_core_1 = require("@glideidentity/glide-be-sdk-node-core");
+Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return glide_be_sdk_node_core_1.ErrorCode; } });
+/**
+ * Error thrown by Magical Auth operations.
+ *
+ * @example
+ * try {
+ *     await client.magicalAuth.prepare(request);
+ * } catch (error) {
+ *     if (error instanceof MagicalAuthError) {
+ *         console.log(error.code, error.status);
+ *     }
+ * }
+ */
+class MagicalAuthError extends Error {
+    constructor(errorResponse) {
+        super(errorResponse.message || 'Magical Auth Error');
+        this.name = 'MagicalAuthError';
+        Object.defineProperty(this, 'stack', {
+            enumerable: false,
+            configurable: true,
+            writable: true,
+            value: this.stack
+        });
+        this.code = errorResponse.code || glide_be_sdk_node_core_1.ErrorCode.INTERNAL_SERVER_ERROR;
+        this.status = errorResponse.status ?? 500;
+        this.requestId = errorResponse.requestId || errorResponse.request_id;
+        this.timestamp = errorResponse.timestamp;
+        this.traceId = errorResponse.traceId || errorResponse.trace_id;
+        this.spanId = errorResponse.spanId || errorResponse.span_id;
+        this.service = errorResponse.service;
+        this.details = errorResponse.details;
+        Object.setPrototypeOf(this, MagicalAuthError.prototype);
+    }
+    /** Checks if error matches the specified code. */
+    is(code) {
+        return this.code === code;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            status: this.status,
+            request_id: this.requestId,
+            timestamp: this.timestamp,
+            trace_id: this.traceId,
+            span_id: this.spanId,
+            service: this.service,
+            details: this.details
+        };
+    }
+    /** Custom inspect for cleaner console output (Node.js). */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        const props = [`code: '${this.code}'`, `status: ${this.status}`];
+        if (this.requestId)
+            props.push(`requestId: '${this.requestId}'`);
+        if (this.details)
+            props.push(`details: ${JSON.stringify(this.details)}`);
+        return `MagicalAuthError: ${this.message} { ${props.join(', ')} }`;
+    }
+}
+exports.MagicalAuthError = MagicalAuthError;

package/dist/glide.d.ts

@@ -0,0 +1,31 @@
+import { GlideSdkSettings } from './types';
+import { MagicalAuth } from './services/magical-auth';
+/**
+ * Glide API client.
+ *
+ * @example
+ * const client = new GlideClient({
+ *     clientId: process.env.GLIDE_CLIENT_ID,
+ *     clientSecret: process.env.GLIDE_CLIENT_SECRET
+ * });
+ * const response = await client.magicalAuth.prepare({ use_case: UseCase.VERIFY_PHONE_NUMBER, phone_number: '+14155551234' });
+ */
+export declare class GlideClient {
+    private settings;
+    private logger;
+    private oauthClient;
+    /** Magical Auth service for phone verification. */
+    magicalAuth: MagicalAuth;
+    /**
+     * Creates a new Glide client.
+     * @param settings - Client configuration. Client ID and Client Secret are required.
+     * @throws Error if credentials are not provided.
+     */
+    constructor(settings?: Partial<GlideSdkSettings>);
+    /**
+     * Clears the cached OAuth token, forcing a refresh on the next API call.
+     * Useful for handling token invalidation or testing.
+     */
+    clearTokenCache(): void;
+}
+//# sourceMappingURL=glide.d.ts.map

package/dist/glide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glide.d.ts","sourceRoot":"","sources":["../src/glide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAQtD;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAe;IAElC,mDAAmD;IAC5C,WAAW,EAAE,WAAW,CAAC;IAEhC;;;;OAIG;gBACS,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM;IA0CpD;;;OAGG;IACH,eAAe,IAAI,IAAI;CAG1B"}

package/dist/glide.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlideClient = void 0;
+const magical_auth_1 = require("./services/magical-auth");
+const oauth_1 = require("./internal/oauth");
+const logger_1 = require("./logger");
+const glide_be_sdk_node_core_1 = require("@glideidentity/glide-be-sdk-node-core");
+const DEFAULT_BASE_URL = 'https://api.glideidentity.app';
+/**
+ * Glide API client.
+ *
+ * @example
+ * const client = new GlideClient({
+ *     clientId: process.env.GLIDE_CLIENT_ID,
+ *     clientSecret: process.env.GLIDE_CLIENT_SECRET
+ * });
+ * const response = await client.magicalAuth.prepare({ use_case: UseCase.VERIFY_PHONE_NUMBER, phone_number: '+14155551234' });
+ */
+class GlideClient {
+    /**
+     * Creates a new Glide client.
+     * @param settings - Client configuration. Client ID and Client Secret are required.
+     * @throws Error if credentials are not provided.
+     */
+    constructor(settings = {}) {
+        const clientId = settings.clientId || process.env.GLIDE_CLIENT_ID || '';
+        const clientSecret = settings.clientSecret || process.env.GLIDE_CLIENT_SECRET || '';
+        const baseUrl = settings.baseUrl || process.env.GLIDE_API_BASE_URL || DEFAULT_BASE_URL;
+        if (!clientId) {
+            throw new Error('Client ID is required. Set GLIDE_CLIENT_ID environment variable or pass clientId option');
+        }
+        if (!clientSecret) {
+            throw new Error('Client Secret is required. Set GLIDE_CLIENT_SECRET environment variable or pass clientSecret option');
+        }
+        this.settings = {
+            clientId,
+            clientSecret,
+            baseUrl,
+            logLevel: settings.logLevel,
+            logFormat: settings.logFormat,
+            logger: settings.logger,
+            tokenRefreshBuffer: settings.tokenRefreshBuffer,
+        };
+        this.logger = settings.logger ?? (0, logger_1.createLogger)(settings.logLevel, settings.logFormat);
+        // Initialize OAuth client for token management
+        this.oauthClient = new oauth_1.OAuthManager(clientId, clientSecret, baseUrl, this.logger, settings.tokenRefreshBuffer);
+        this.logger.info('Glide SDK initialized', {
+            version: glide_be_sdk_node_core_1.VERSION,
+            baseUrl: this.settings.baseUrl,
+        });
+        this.magicalAuth = new magical_auth_1.MagicalAuth(this.settings, this.oauthClient, this.logger);
+    }
+    /**
+     * Clears the cached OAuth token, forcing a refresh on the next API call.
+     * Useful for handling token invalidation or testing.
+     */
+    clearTokenCache() {
+        this.oauthClient.clearCache();
+    }
+}
+exports.GlideClient = GlideClient;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from '@glideidentity/glide-be-sdk-node-core';
+export type { GlideSdkSettings, LogFormat, TokenResponse, CachedToken } from './types';
+export { GlideClient } from './glide';
+export type { Logger, LogField } from './logger';
+export { LogLevel, createLogger, generateRequestId } from './logger';
+export { MagicalAuthError } from './errors';
+export { validatePhoneNumber, validatePlmn, validateUseCaseRequirements } from './validation';
+export type { ValidationResult } from './validation';
+export { request, FetchError } from './internal/http';
+export type { RequestOptions, HttpResponse } from './internal/http';
+export { getStatusUrl } from './utils';
+//# 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":"AACA,cAAc,uCAAuC,CAAC;AAGtD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+"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 });
+exports.getStatusUrl = exports.FetchError = exports.request = exports.validateUseCaseRequirements = exports.validatePlmn = exports.validatePhoneNumber = exports.MagicalAuthError = exports.generateRequestId = exports.createLogger = exports.LogLevel = exports.GlideClient = void 0;
+// Re-export all core types and constants (single source of truth)
+__exportStar(require("@glideidentity/glide-be-sdk-node-core"), exports);
+// Main client
+var glide_1 = require("./glide");
+Object.defineProperty(exports, "GlideClient", { enumerable: true, get: function () { return glide_1.GlideClient; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
+Object.defineProperty(exports, "generateRequestId", { enumerable: true, get: function () { return logger_1.generateRequestId; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "MagicalAuthError", { enumerable: true, get: function () { return errors_1.MagicalAuthError; } });
+// Validation
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validatePhoneNumber", { enumerable: true, get: function () { return validation_1.validatePhoneNumber; } });
+Object.defineProperty(exports, "validatePlmn", { enumerable: true, get: function () { return validation_1.validatePlmn; } });
+Object.defineProperty(exports, "validateUseCaseRequirements", { enumerable: true, get: function () { return validation_1.validateUseCaseRequirements; } });
+// HTTP utilities - for advanced usage and dev-server
+var http_1 = require("./internal/http");
+Object.defineProperty(exports, "request", { enumerable: true, get: function () { return http_1.request; } });
+Object.defineProperty(exports, "FetchError", { enumerable: true, get: function () { return http_1.FetchError; } });
+// Utility functions
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getStatusUrl", { enumerable: true, get: function () { return utils_1.getStatusUrl; } });

package/dist/internal/http.d.ts

@@ -0,0 +1,20 @@
+import * as http from 'http';
+export declare class FetchError extends Error {
+    response: http.IncomingMessage;
+    data: string;
+    constructor(response: http.IncomingMessage, data: string);
+}
+export interface RequestOptions {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    timeout?: number;
+}
+export interface HttpResponse {
+    json: <T = unknown>() => T;
+    text: () => string;
+    ok: boolean;
+    status: number;
+}
+export declare function request(url: string, options: RequestOptions): Promise<HttpResponse>;
+//# sourceMappingURL=http.d.ts.map

package/dist/internal/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/internal/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,qBAAa,UAAW,SAAQ,KAAK;IAC1B,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;gBAER,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM;CAK3D;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CA+CnF"}

package/dist/internal/http.js

@@ -0,0 +1,89 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchError = void 0;
+exports.request = request;
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+const glide_be_sdk_node_core_1 = require("@glideidentity/glide-be-sdk-node-core");
+class FetchError extends Error {
+    constructor(response, data) {
+        super(`Fetch Error: ${response.statusCode} ${response.statusMessage}`);
+        this.response = response;
+        this.data = data;
+    }
+}
+exports.FetchError = FetchError;
+function request(url, options) {
+    return new Promise((resolve, reject) => {
+        const urlObj = new URL(url);
+        const client = urlObj.protocol === 'https:' ? https : http;
+        const req = client.request(url, {
+            method: options.method,
+            headers: {
+                'User-Agent': `glide-be-sdk-node/${glide_be_sdk_node_core_1.VERSION}`,
+                ...options.headers,
+            },
+            timeout: options.timeout || 30000,
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+            res.on('end', () => {
+                const status = res.statusCode || 500;
+                if (status >= 400) {
+                    reject(new FetchError(res, data));
+                    return;
+                }
+                resolve({
+                    json: () => JSON.parse(data),
+                    text: () => data,
+                    ok: status < 400,
+                    status,
+                });
+            });
+        });
+        req.on('error', reject);
+        req.on('timeout', () => {
+            req.destroy();
+            reject(new Error('Request timeout'));
+        });
+        if (options.body) {
+            req.write(options.body);
+        }
+        req.end();
+    });
+}

package/dist/internal/oauth.d.ts

@@ -0,0 +1,53 @@
+import type { Logger } from '../logger';
+/**
+ * OAuth2 Client Credentials authentication manager.
+ * Manages token fetching and caching with automatic refresh before expiry.
+ */
+export declare class OAuthManager {
+    private clientId;
+    private clientSecret;
+    private tokenUrl;
+    private refreshBuffer;
+    private logger;
+    private cachedToken;
+    /** Pending token fetch promise for request deduplication. */
+    private pendingTokenPromise;
+    constructor(clientId: string, clientSecret: string, baseUrl: string, logger: Logger, refreshBuffer?: number);
+    /**
+     * Gets a valid access token, fetching a new one if necessary.
+     * Implements lazy refresh - tokens are refreshed before they expire.
+     * Uses pending promise deduplication to prevent multiple concurrent token fetches.
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Fetches and caches a new token. Separated for promise deduplication.
+     */
+    private fetchAndCacheToken;
+    /**
+     * Checks if the cached token is still valid (not expired or about to expire).
+     */
+    private isTokenValid;
+    /**
+     * Fetches a new access token from the OAuth2 token endpoint.
+     * Uses HTTP Basic authentication with base64-encoded credentials.
+     * Most OAuth2 servers expect raw client credentials to be base64-encoded directly
+     * in the Authorization header without additional URL-encoding.
+     *
+     */
+    private fetchToken;
+    /**
+     * Caches the token with its expiration time.
+     */
+    private cacheToken;
+    /**
+     * Clears the cached token. Useful for forcing a token refresh.
+     */
+    clearCache(): void;
+}
+export declare class OAuthError extends Error {
+    readonly statusCode: number;
+    readonly statusMessage: string;
+    constructor(statusCode: number, statusMessage: string);
+}
+export { OAuthManager as OAuthClient };
+//# sourceMappingURL=oauth.d.ts.map

package/dist/internal/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/internal/oauth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKxC;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA4B;IAC/C,6DAA6D;IAC7D,OAAO,CAAC,mBAAmB,CAAgC;gBAGvD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAA6C;IAShE;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAyBvC;;OAEG;YACW,kBAAkB;IAMhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;;;;;OAMG;YACW,UAAU;IAqCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,UAAU,IAAI,IAAI;CAIrB;AAED,qBAAa,UAAW,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAMxD;AAGD,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,CAAC"}