@appcorp/stellar-solutions-modules 0.1.38 → 0.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appcorp/stellar-solutions-modules",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "scripts": {
     "automate": "./automate.sh",
     "build": "yarn clean && yarn build:ts && cp package.json lib && cp README.md lib && cp yarn.lock lib",

package/supabase/supabase.d.ts

@@ -1,83 +1,6 @@
-/**
- * Supabase Client Configuration
- *
- * This module provides centralized Supabase client configuration and utilities.
- * Handles authentication, storage URLs, and client initialization with proper error handling.
- *
- * Features:
- * - Centralized Supabase client configuration
- * - Storage URL management for public and private buckets
- * - Environment variable validation
- * - Type-safe client creation
- * - Authentication persistence configuration
- *
- * Environment Variables Required:
- * - NEXT_PUBLIC_SUPABASE_URL: Supabase project URL
- * - NEXT_PUBLIC_SUPABASE_ANON_KEY: Supabase anonymous key
- * - NEXT_PUBLIC_SUPABASE_STORAGE_URL: Storage base URL
- * - NEXT_PUBLIC_SUPABASE_PRIVATE_BUCKET: Private bucket name
- * - NEXT_PUBLIC_SUPABASE_PUBLIC_BUCKET: Public bucket name
- */
-import { SupabaseClient } from "@supabase/supabase-js";
-/**
- * Storage bucket types for type safety
- */
-export type StorageBucketType = "public" | "private" | "authenticated";
-/**
- * Base URL for Supabase storage
- */
 export declare const supabaseStorageBaseUrl: string;
-/**
- * Private storage URL for authenticated users
- * Format: {storageBaseUrl}/authenticated/{privateBucket}
- */
 export declare const supabasePrivateStorageUrl: string;
-/**
- * Public storage URL for publicly accessible files
- * Format: {storageBaseUrl}/public/{publicBucket}
- */
 export declare const supabasePublicStorageUrl: string;
-/**
- * Main Supabase client instance
- * Configured with authentication persistence and optimized settings
- */
-export declare const supabaseClient: SupabaseClient;
-/**
- * Get storage URL for a specific bucket type
- * @param bucketType - Type of storage bucket
- * @returns Full storage URL for the bucket
- */
-export declare const getStorageUrl: (bucketType: StorageBucketType) => string;
-/**
- * Get public file URL from Supabase storage
- * @param bucket - Bucket name
- * @param filePath - Path to the file within the bucket
- * @returns Public URL for the file
- */
-export declare const getPublicFileUrl: (bucket: string, filePath: string) => string;
-/**
- * Get authenticated file URL from Supabase storage
- * @param bucket - Bucket name
- * @param filePath - Path to the file within the bucket
- * @returns Authenticated URL for the file
- */
-export declare const getAuthenticatedFileUrl: (bucket: string, filePath: string) => string;
-/**
- * Check if Supabase client is properly initialized
- * @returns True if client is initialized, false otherwise
- */
-export declare const isSupabaseClientReady: () => boolean;
-/**
- * Get current session from Supabase auth
- * @returns Current user session or null
- */
-export declare const getCurrentSession: () => Promise<import("@supabase/supabase-js").AuthSession | null>;
-/**
- * Check if user is authenticated
- * @returns True if user is authenticated, false otherwise
- */
-export declare const isAuthenticated: () => Promise<boolean>;
-/**
- * Re-export Supabase types for convenience
- */
-export type { SupabaseClient } from "@supabase/supabase-js";
+export declare const supabaseUrl: string;
+export declare const supabaseKey: string;
+export declare const supabaseClient: import("@supabase/supabase-js").SupabaseClient<any, "public", "public", any, any>;

package/supabase/supabase.js

@@ -1,290 +1,15 @@
 "use strict";
-/**
- * Supabase Client Configuration
- *
- * This module provides centralized Supabase client configuration and utilities.
- * Handles authentication, storage URLs, and client initialization with proper error handling.
- *
- * Features:
- * - Centralized Supabase client configuration
- * - Storage URL management for public and private buckets
- * - Environment variable validation
- * - Type-safe client creation
- * - Authentication persistence configuration
- *
- * Environment Variables Required:
- * - NEXT_PUBLIC_SUPABASE_URL: Supabase project URL
- * - NEXT_PUBLIC_SUPABASE_ANON_KEY: Supabase anonymous key
- * - NEXT_PUBLIC_SUPABASE_STORAGE_URL: Storage base URL
- * - NEXT_PUBLIC_SUPABASE_PRIVATE_BUCKET: Private bucket name
- * - NEXT_PUBLIC_SUPABASE_PUBLIC_BUCKET: Public bucket name
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAuthenticated = exports.getCurrentSession = exports.isSupabaseClientReady = exports.getAuthenticatedFileUrl = exports.getPublicFileUrl = exports.getStorageUrl = exports.supabaseClient = exports.supabasePublicStorageUrl = exports.supabasePrivateStorageUrl = exports.supabaseStorageBaseUrl = void 0;
+exports.supabaseClient = exports.supabaseKey = exports.supabaseUrl = exports.supabasePublicStorageUrl = exports.supabasePrivateStorageUrl = exports.supabaseStorageBaseUrl = void 0;
 var supabase_js_1 = require("@supabase/supabase-js");
-// ============================================================================
-// ENVIRONMENT VALIDATION
-// ============================================================================
-/**
- * Validates required Supabase environment variables
- * Throws an error if any required environment variable is missing
- */
-var validateEnvironmentVariables = function () {
-    var requiredVars = [
-        "NEXT_PUBLIC_SUPABASE_URL",
-        "NEXT_PUBLIC_SUPABASE_ANON_KEY",
-        "NEXT_PUBLIC_SUPABASE_STORAGE_URL",
-        "NEXT_PUBLIC_SUPABASE_PRIVATE_BUCKET",
-        "NEXT_PUBLIC_SUPABASE_PUBLIC_BUCKET",
-    ];
-    var missingVars = requiredVars.filter(function (varName) { return !process.env[varName]; });
-    if (missingVars.length > 0) {
-        throw new Error("Missing required Supabase environment variables: ".concat(missingVars.join(", ")));
-    }
-};
-// ============================================================================
-// CONFIGURATION CONSTANTS
-// ============================================================================
-/**
- * Supabase client configuration options
- */
-var SUPABASE_CONFIG = {
-    auth: {
-        persistSession: true,
-        autoRefreshToken: true,
-        detectSessionInUrl: true,
-    },
-    realtime: {
-        params: {
-            eventsPerSecond: 10,
-        },
-    },
-    global: {
-        headers: {
-            "X-Client-Info": "stellar-solutions-modules",
-        },
-    },
-};
-// ============================================================================
-// STORAGE URL CONFIGURATION
-// ============================================================================
-/**
- * Base URL for Supabase storage
- */
 exports.supabaseStorageBaseUrl = process.env
     .NEXT_PUBLIC_SUPABASE_STORAGE_URL;
-/**
- * Private storage URL for authenticated users
- * Format: {storageBaseUrl}/authenticated/{privateBucket}
- */
 exports.supabasePrivateStorageUrl = "".concat(exports.supabaseStorageBaseUrl, "/authenticated/").concat(process.env.NEXT_PUBLIC_SUPABASE_PRIVATE_BUCKET);
-/**
- * Public storage URL for publicly accessible files
- * Format: {storageBaseUrl}/public/{publicBucket}
- */
 exports.supabasePublicStorageUrl = "".concat(exports.supabaseStorageBaseUrl, "/public/").concat(process.env.NEXT_PUBLIC_SUPABASE_PUBLIC_BUCKET);
-// ============================================================================
-// SUPABASE CLIENT INITIALIZATION
-// ============================================================================
-/**
- * Supabase project URL from environment variables
- */
-var supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
-/**
- * Supabase anonymous key from environment variables
- */
-var supabaseKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
-/**
- * Main Supabase client instance
- * Configured with authentication persistence and optimized settings
- */
-exports.supabaseClient = (function () {
-    // Validate environment variables before creating client
-    validateEnvironmentVariables();
-    try {
-        return (0, supabase_js_1.createClient)(supabaseUrl, supabaseKey, SUPABASE_CONFIG);
-    }
-    catch (error) {
-        console.error("Failed to initialize Supabase client:", error);
-        throw new Error("Supabase client initialization failed. Check your environment variables.");
-    }
-})();
-// ============================================================================
-// UTILITY FUNCTIONS
-// ============================================================================
-/**
- * Get storage URL for a specific bucket type
- * @param bucketType - Type of storage bucket
- * @returns Full storage URL for the bucket
- */
-var getStorageUrl = function (bucketType) {
-    switch (bucketType) {
-        case "public":
-            return exports.supabasePublicStorageUrl;
-        case "private":
-        case "authenticated":
-            return exports.supabasePrivateStorageUrl;
-        default:
-            throw new Error("Invalid bucket type: ".concat(bucketType));
-    }
-};
-exports.getStorageUrl = getStorageUrl;
-/**
- * Get public file URL from Supabase storage
- * @param bucket - Bucket name
- * @param filePath - Path to the file within the bucket
- * @returns Public URL for the file
- */
-var getPublicFileUrl = function (bucket, filePath) {
-    return "".concat(exports.supabaseStorageBaseUrl, "/public/").concat(bucket, "/").concat(filePath);
-};
-exports.getPublicFileUrl = getPublicFileUrl;
-/**
- * Get authenticated file URL from Supabase storage
- * @param bucket - Bucket name
- * @param filePath - Path to the file within the bucket
- * @returns Authenticated URL for the file
- */
-var getAuthenticatedFileUrl = function (bucket, filePath) {
-    return "".concat(exports.supabaseStorageBaseUrl, "/authenticated/").concat(bucket, "/").concat(filePath);
-};
-exports.getAuthenticatedFileUrl = getAuthenticatedFileUrl;
-/**
- * Check if Supabase client is properly initialized
- * @returns True if client is initialized, false otherwise
- */
-var isSupabaseClientReady = function () {
-    try {
-        return !!exports.supabaseClient && typeof exports.supabaseClient.from === "function";
-    }
-    catch (_a) {
-        return false;
-    }
-};
-exports.isSupabaseClientReady = isSupabaseClientReady;
-/**
- * Get current session from Supabase auth
- * @returns Current user session or null
- */
-var getCurrentSession = function () { return __awaiter(void 0, void 0, void 0, function () {
-    var _a, session, error, error_1;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0:
-                _b.trys.push([0, 2, , 3]);
-                return [4 /*yield*/, exports.supabaseClient.auth.getSession()];
-            case 1:
-                _a = _b.sent(), session = _a.data.session, error = _a.error;
-                if (error) {
-                    console.warn("Failed to get current session:", error.message);
-                    return [2 /*return*/, null];
-                }
-                return [2 /*return*/, session];
-            case 2:
-                error_1 = _b.sent();
-                console.error("Error getting current session:", error_1);
-                return [2 /*return*/, null];
-            case 3: return [2 /*return*/];
-        }
-    });
-}); };
-exports.getCurrentSession = getCurrentSession;
-/**
- * Check if user is authenticated
- * @returns True if user is authenticated, false otherwise
- */
-var isAuthenticated = function () { return __awaiter(void 0, void 0, void 0, function () {
-    var session;
-    return __generator(this, function (_a) {
-        switch (_a.label) {
-            case 0: return [4 /*yield*/, (0, exports.getCurrentSession)()];
-            case 1:
-                session = _a.sent();
-                return [2 /*return*/, !!(session === null || session === void 0 ? void 0 : session.user)];
-        }
-    });
-}); };
-exports.isAuthenticated = isAuthenticated;
-// ============================================================================
-// OPTIMIZATION SUMMARY
-// ============================================================================
-/*
- * Supabase Configuration File Optimizations Applied:
- *
- * 1. **Comprehensive Documentation**
- *    - Added detailed JSDoc comments for all exports and functions
- *    - Explained environment variable requirements
- *    - Documented configuration options and their purposes
- *
- * 2. **Enhanced Error Handling**
- *    - Added environment variable validation with descriptive error messages
- *    - Wrapped client creation in try-catch with proper error handling
- *    - Added runtime checks for client initialization
- *
- * 3. **Improved Configuration**
- *    - Enhanced Supabase client configuration with additional options
- *    - Added proper TypeScript types for storage bucket types
- *    - Organized configuration into logical constants
- *
- * 4. **Utility Functions**
- *    - Added helper functions for common storage operations
- *    - Implemented authentication state checking utilities
- *    - Created type-safe URL generation functions
- *
- * 5. **Type Safety Improvements**
- *    - Added proper TypeScript types and interfaces
- *    - Exported Supabase types for external use
- *    - Used const assertions for configuration objects
- *
- * 6. **Developer Experience**
- *    - Clear separation of concerns with section headers
- *    - Self-documenting code with comprehensive comments
- *    - Easy to extend and maintain
- *    - Proper error messages for debugging
- *
- * 7. **Performance Optimizations**
- *    - Lazy initialization of Supabase client
- *    - Efficient environment variable validation
- *    - Optimized configuration for better performance
- *
- * 8. **Security Enhancements**
- *    - Proper validation of environment variables
- *    - Secure handling of authentication tokens
- *    - Type-safe operations to prevent runtime errors
- */
+exports.supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+exports.supabaseKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+exports.supabaseClient = (0, supabase_js_1.createClient)(exports.supabaseUrl, exports.supabaseKey, {
+    auth: {
+        persistSession: true,
+    },
+});