@omnibase/core-js 0.6.0 → 0.7.1

package/dist/payments/index.cjs

@@ -60,31 +60,20 @@ var CheckoutManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * Creating a checkout session (mode is auto-detected):
    * ```typescript
    * const session = await checkoutManager.createSession({
-   *   price_id: 'price_one_time_product',
+   *   price_id: 'price_monthly_pro',
    *   success_url: 'https://app.com/success',
    *   cancel_url: 'https://app.com/cancel'
    * });
    *
    * // Redirect to Stripe checkout
-   * window.location.href = session.data.url;
-   * ```
-   *
-   * @example
-   * Checkout with session tracking:
-   * ```typescript
-   * const session = await checkoutManager.createSession({
-   *   price_id: 'price_monthly_plan',
-   *   success_url: 'https://app.com/dashboard?session_id={CHECKOUT_SESSION_ID}',
-   *   cancel_url: 'https://app.com/pricing',
-   * });
-   *
-   * console.log(`Session created: ${session.data.sessionId}`);
+   * if (session.data?.url) {
+   *   window.location.href = session.data.url;
+   * }
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Checkout
    */
   async createSession(options) {
@@ -305,7 +294,7 @@ var PortalManager = class {
   /**
    * Initialize the portal manager
    *
-   * @param paymentHandler - Payment handler instance for API communication
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @group Portal
    */
@@ -332,32 +321,18 @@ var PortalManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * Basic portal creation:
    * ```typescript
    * const portal = await portalManager.create({
    *   return_url: 'https://myapp.com/account/billing'
    * });
    *
    * // Redirect user to portal
-   * window.location.href = portal.data.url;
-   * ```
-   *
-   * @example
-   * With error handling:
-   * ```typescript
-   * try {
-   *   const portal = await portalManager.create({
-   *     return_url: window.location.origin + '/billing'
-   *   });
-   *
+   * if (portal.data?.url) {
    *   window.location.href = portal.data.url;
-   * } catch (error) {
-   *   console.error('Failed to create portal session:', error);
-   *   showErrorMessage('Unable to access billing portal. Please try again.');
    * }
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Portal
    */
   async create(options) {
@@ -387,7 +362,7 @@ var UsageManager = class {
   /**
    * Initialize the usage manager
    *
-   * @param paymentHandler - Payment handler instance for API communication
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @group Usage
    */
@@ -416,7 +391,6 @@ var UsageManager = class {
    * @throws {ValidationError} When required parameters are missing or invalid
    *
    * @example
-   * API call tracking:
    * ```typescript
    * // Record each API call
    * await usageManager.recordUsage({
@@ -425,37 +399,7 @@ var UsageManager = class {
    * });
    * ```
    *
-   * @example
-   * Batch usage recording:
-   * ```typescript
-   * // Record multiple operations at once
-   * const usageEvents = [
-   *   { meter_event_name: 'compute_hours', value: '0.5' },
-   *   { meter_event_name: 'storage_gb', value: '10' },
-   *   { meter_event_name: 'api_calls', value: '50' }
-   * ];
-   *
-   * for (const event of usageEvents) {
-   *   await usageManager.recordUsage(event);
-   * }
-   * ```
-   *
-   * @example
-   * With error handling:
-   * ```typescript
-   * try {
-   *   await usageManager.recordUsage({
-   *     meter_event_name: 'file_uploads',
-   *     value: String(uploadedFiles.length)
-   *   });
-   * } catch (error) {
-   *   console.error('Failed to record usage:', error);
-   *   // Usage recording failure shouldn't block user operations
-   *   // but should be logged for billing accuracy
-   * }
-   * ```
-   *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Usage
    */
   async recordUsage(options) {
@@ -480,20 +424,20 @@ var UsageManager = class {
 // src/payments/handler.ts
 var PaymentHandler = class {
   /**
-   * Initialize the payment handler with API configuration
+   * Initialize the payment handler with OmnibaseClient
    *
-   * Creates a new payment handler instance that will communicate with
-   * the specified API endpoint. The handler automatically handles
-   * request formatting and authentication headers.
+   * Creates a new payment handler instance with access to all payment
+   * operations including checkout, configuration, portal, and usage tracking.
+   * The handler uses the provided OmnibaseClient for API communication.
    *
-   * @param apiUrl - Base URL for the payment API endpoint
+   * @param omnibaseClient - OmnibaseClient instance for API communication
    *
    * @example
    * ```typescript
-   * const paymentHandler = new PaymentHandler('https://api.myapp.com');
+   * const paymentHandler = new PaymentHandler(omnibaseClient);
    * ```
    *
-   * @since 1.0.0
+   * @since 0.6.0
    * @group Client
    */
   constructor(omnibaseClient) {
@@ -512,10 +456,14 @@ var PaymentHandler = class {
    * @example
    * ```typescript
    * const session = await paymentHandler.checkout.createSession({
-   *   price_id: 'price_monthly',
+   *   price_id: 'price_monthly_pro',
    *   success_url: window.location.origin + '/success',
    *   cancel_url: window.location.origin + '/pricing'
    * });
+   *
+   * if (session.data?.url) {
+   *   window.location.href = session.data.url;
+   * }
    * ```
    */
   checkout;