@usequota/nextjs 0.1.0

package/dist/chunk-SJ3X4KTV.mjs

@@ -0,0 +1,117 @@
+// src/errors.ts
+var QuotaError = class extends Error {
+  /** Machine-readable error code */
+  code;
+  /** HTTP status code associated with this error */
+  statusCode;
+  /** Optional hint for resolving the error */
+  hint;
+  constructor(message, code, statusCode, hint) {
+    super(message);
+    this.name = "QuotaError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.hint = hint;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaInsufficientCreditsError = class extends QuotaError {
+  /** Current balance (if available) */
+  balance;
+  /** Credits required for the operation (if available) */
+  required;
+  constructor(message, options) {
+    super(
+      message ?? "Insufficient credits to complete this operation",
+      "insufficient_credits",
+      402,
+      "Purchase more credits or reduce usage"
+    );
+    this.name = "QuotaInsufficientCreditsError";
+    this.balance = options?.balance;
+    this.required = options?.required;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaNotConnectedError = class extends QuotaError {
+  constructor(message) {
+    super(
+      message ?? "User has not connected a Quota account",
+      "not_connected",
+      401,
+      "Connect your Quota account to use this feature"
+    );
+    this.name = "QuotaNotConnectedError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaTokenExpiredError = class extends QuotaError {
+  constructor(message) {
+    super(
+      message ?? "Quota access token has expired and could not be refreshed",
+      "token_expired",
+      401,
+      "Reconnect your Quota account"
+    );
+    this.name = "QuotaTokenExpiredError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaRateLimitError = class extends QuotaError {
+  /** Seconds until the rate limit resets */
+  retryAfter;
+  constructor(message, retryAfter) {
+    super(
+      message ?? "Rate limit exceeded",
+      "rate_limit_exceeded",
+      429,
+      "Wait before retrying"
+    );
+    this.name = "QuotaRateLimitError";
+    this.retryAfter = retryAfter ?? 60;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+async function errorFromResponse(response) {
+  if (response.ok) {
+    return null;
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+  }
+  const message = body?.error?.message ?? response.statusText;
+  const code = body?.error?.code;
+  switch (response.status) {
+    case 402:
+      return new QuotaInsufficientCreditsError(message, {
+        balance: body?.error?.balance,
+        required: body?.error?.required
+      });
+    case 429: {
+      const retryAfter = parseInt(
+        response.headers.get("retry-after") ?? "60",
+        10
+      );
+      return new QuotaRateLimitError(message, retryAfter);
+    }
+    case 401: {
+      if (code === "not_connected") {
+        return new QuotaNotConnectedError(message);
+      }
+      return new QuotaTokenExpiredError(message);
+    }
+    default:
+      return new QuotaError(message, code ?? "unknown", response.status);
+  }
+}
+
+export {
+  QuotaError,
+  QuotaInsufficientCreditsError,
+  QuotaNotConnectedError,
+  QuotaTokenExpiredError,
+  QuotaRateLimitError,
+  errorFromResponse
+};

package/dist/chunk-ZF7WJBQC.mjs

@@ -0,0 +1,114 @@
+// src/errors.ts
+var QuotaError = class extends Error {
+  /** Machine-readable error code */
+  code;
+  /** HTTP status code associated with this error */
+  statusCode;
+  /** Optional hint for resolving the error */
+  hint;
+  constructor(message, code, statusCode, hint) {
+    super(message);
+    this.name = "QuotaError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.hint = hint;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaInsufficientCreditsError = class extends QuotaError {
+  /** Current balance (if available) */
+  balance;
+  /** Credits required for the operation (if available) */
+  required;
+  constructor(message, options) {
+    super(
+      message ?? "Insufficient credits to complete this operation",
+      "insufficient_credits",
+      402,
+      "Purchase more credits or reduce usage"
+    );
+    this.name = "QuotaInsufficientCreditsError";
+    this.balance = options?.balance;
+    this.required = options?.required;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaNotConnectedError = class extends QuotaError {
+  constructor(message) {
+    super(
+      message ?? "User has not connected a Quota account",
+      "not_connected",
+      401,
+      "Connect your Quota account to use this feature"
+    );
+    this.name = "QuotaNotConnectedError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaTokenExpiredError = class extends QuotaError {
+  constructor(message) {
+    super(
+      message ?? "Quota access token has expired and could not be refreshed",
+      "token_expired",
+      401,
+      "Reconnect your Quota account"
+    );
+    this.name = "QuotaTokenExpiredError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var QuotaRateLimitError = class extends QuotaError {
+  /** Seconds until the rate limit resets */
+  retryAfter;
+  constructor(message, retryAfter) {
+    super(
+      message ?? "Rate limit exceeded",
+      "rate_limit_exceeded",
+      429,
+      "Wait before retrying"
+    );
+    this.name = "QuotaRateLimitError";
+    this.retryAfter = retryAfter ?? 60;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+async function errorFromResponse(response) {
+  if (response.ok) {
+    return null;
+  }
+  let body;
+  try {
+    body = await response.json();
+  } catch {
+  }
+  const message = body?.error?.message ?? response.statusText;
+  const code = body?.error?.code;
+  switch (response.status) {
+    case 402:
+      return new QuotaInsufficientCreditsError(message);
+    case 429: {
+      const retryAfter = parseInt(
+        response.headers.get("retry-after") ?? "60",
+        10
+      );
+      return new QuotaRateLimitError(message, retryAfter);
+    }
+    case 401: {
+      if (code === "not_connected") {
+        return new QuotaNotConnectedError(message);
+      }
+      return new QuotaTokenExpiredError(message);
+    }
+    default:
+      return new QuotaError(message, code ?? "unknown", response.status);
+  }
+}
+
+export {
+  QuotaError,
+  QuotaInsufficientCreditsError,
+  QuotaNotConnectedError,
+  QuotaTokenExpiredError,
+  QuotaRateLimitError,
+  errorFromResponse
+};

package/dist/errors-CmNx3kSz.d.mts

@@ -0,0 +1,109 @@
+/**
+ * @usequota/nextjs - Typed error classes for Quota SDK
+ *
+ * Provides specific error classes for common Quota error scenarios,
+ * enabling pattern matching with instanceof checks.
+ */
+/**
+ * Base error class for all Quota SDK errors
+ */
+declare class QuotaError extends Error {
+    /** Machine-readable error code */
+    readonly code: string;
+    /** HTTP status code associated with this error */
+    readonly statusCode: number;
+    /** Optional hint for resolving the error */
+    readonly hint: string | undefined;
+    constructor(message: string, code: string, statusCode: number, hint?: string);
+}
+/**
+ * Thrown when a user does not have enough credits for an operation
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await makeAICall();
+ * } catch (e) {
+ *   if (e instanceof QuotaInsufficientCreditsError) {
+ *     // Prompt user to buy more credits
+ *     showBuyCreditsDialog();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaInsufficientCreditsError extends QuotaError {
+    /** Current balance (if available) */
+    readonly balance: number | undefined;
+    /** Credits required for the operation (if available) */
+    readonly required: number | undefined;
+    constructor(message?: string, options?: {
+        balance?: number;
+        required?: number;
+    });
+}
+/**
+ * Thrown when a user has not connected their Quota account
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = await getQuotaUser(config);
+ * } catch (e) {
+ *   if (e instanceof QuotaNotConnectedError) {
+ *     // Redirect to Quota OAuth
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaNotConnectedError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the OAuth access token has expired and cannot be refreshed
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaTokenExpiredError) {
+ *     // Re-authenticate the user
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaTokenExpiredError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Quota API rate limit is exceeded
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaRateLimitError) {
+ *     // Wait and retry
+ *     await delay(e.retryAfter * 1000);
+ *     await callQuotaAPI();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaRateLimitError extends QuotaError {
+    /** Seconds until the rate limit resets */
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Maps an HTTP response to the appropriate typed error.
+ * Returns null if the response doesn't represent a known error.
+ *
+ * @internal
+ */
+declare function errorFromResponse(response: Response): Promise<QuotaError | null>;
+
+export { QuotaError as Q, QuotaInsufficientCreditsError as a, QuotaNotConnectedError as b, QuotaTokenExpiredError as c, QuotaRateLimitError as d, errorFromResponse as e };

package/dist/errors-CmNx3kSz.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @usequota/nextjs - Typed error classes for Quota SDK
+ *
+ * Provides specific error classes for common Quota error scenarios,
+ * enabling pattern matching with instanceof checks.
+ */
+/**
+ * Base error class for all Quota SDK errors
+ */
+declare class QuotaError extends Error {
+    /** Machine-readable error code */
+    readonly code: string;
+    /** HTTP status code associated with this error */
+    readonly statusCode: number;
+    /** Optional hint for resolving the error */
+    readonly hint: string | undefined;
+    constructor(message: string, code: string, statusCode: number, hint?: string);
+}
+/**
+ * Thrown when a user does not have enough credits for an operation
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await makeAICall();
+ * } catch (e) {
+ *   if (e instanceof QuotaInsufficientCreditsError) {
+ *     // Prompt user to buy more credits
+ *     showBuyCreditsDialog();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaInsufficientCreditsError extends QuotaError {
+    /** Current balance (if available) */
+    readonly balance: number | undefined;
+    /** Credits required for the operation (if available) */
+    readonly required: number | undefined;
+    constructor(message?: string, options?: {
+        balance?: number;
+        required?: number;
+    });
+}
+/**
+ * Thrown when a user has not connected their Quota account
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = await getQuotaUser(config);
+ * } catch (e) {
+ *   if (e instanceof QuotaNotConnectedError) {
+ *     // Redirect to Quota OAuth
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaNotConnectedError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the OAuth access token has expired and cannot be refreshed
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaTokenExpiredError) {
+ *     // Re-authenticate the user
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaTokenExpiredError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Quota API rate limit is exceeded
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaRateLimitError) {
+ *     // Wait and retry
+ *     await delay(e.retryAfter * 1000);
+ *     await callQuotaAPI();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaRateLimitError extends QuotaError {
+    /** Seconds until the rate limit resets */
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Maps an HTTP response to the appropriate typed error.
+ * Returns null if the response doesn't represent a known error.
+ *
+ * @internal
+ */
+declare function errorFromResponse(response: Response): Promise<QuotaError | null>;
+
+export { QuotaError as Q, QuotaInsufficientCreditsError as a, QuotaNotConnectedError as b, QuotaTokenExpiredError as c, QuotaRateLimitError as d, errorFromResponse as e };

package/dist/errors-DVurmYT7.d.mts

@@ -0,0 +1,109 @@
+/**
+ * @quota/nextjs - Typed error classes for Quota SDK
+ *
+ * Provides specific error classes for common Quota error scenarios,
+ * enabling pattern matching with instanceof checks.
+ */
+/**
+ * Base error class for all Quota SDK errors
+ */
+declare class QuotaError extends Error {
+    /** Machine-readable error code */
+    readonly code: string;
+    /** HTTP status code associated with this error */
+    readonly statusCode: number;
+    /** Optional hint for resolving the error */
+    readonly hint: string | undefined;
+    constructor(message: string, code: string, statusCode: number, hint?: string);
+}
+/**
+ * Thrown when a user does not have enough credits for an operation
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await makeAICall();
+ * } catch (e) {
+ *   if (e instanceof QuotaInsufficientCreditsError) {
+ *     // Prompt user to buy more credits
+ *     showBuyCreditsDialog();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaInsufficientCreditsError extends QuotaError {
+    /** Current balance (if available) */
+    readonly balance: number | undefined;
+    /** Credits required for the operation (if available) */
+    readonly required: number | undefined;
+    constructor(message?: string, options?: {
+        balance?: number;
+        required?: number;
+    });
+}
+/**
+ * Thrown when a user has not connected their Quota account
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = await getQuotaUser(config);
+ * } catch (e) {
+ *   if (e instanceof QuotaNotConnectedError) {
+ *     // Redirect to Quota OAuth
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaNotConnectedError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the OAuth access token has expired and cannot be refreshed
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaTokenExpiredError) {
+ *     // Re-authenticate the user
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaTokenExpiredError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Quota API rate limit is exceeded
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaRateLimitError) {
+ *     // Wait and retry
+ *     await delay(e.retryAfter * 1000);
+ *     await callQuotaAPI();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaRateLimitError extends QuotaError {
+    /** Seconds until the rate limit resets */
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Maps an HTTP response to the appropriate typed error.
+ * Returns null if the response doesn't represent a known error.
+ *
+ * @internal
+ */
+declare function errorFromResponse(response: Response): Promise<QuotaError | null>;
+
+export { QuotaError as Q, QuotaInsufficientCreditsError as a, QuotaNotConnectedError as b, QuotaTokenExpiredError as c, QuotaRateLimitError as d, errorFromResponse as e };

package/dist/errors-DVurmYT7.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @quota/nextjs - Typed error classes for Quota SDK
+ *
+ * Provides specific error classes for common Quota error scenarios,
+ * enabling pattern matching with instanceof checks.
+ */
+/**
+ * Base error class for all Quota SDK errors
+ */
+declare class QuotaError extends Error {
+    /** Machine-readable error code */
+    readonly code: string;
+    /** HTTP status code associated with this error */
+    readonly statusCode: number;
+    /** Optional hint for resolving the error */
+    readonly hint: string | undefined;
+    constructor(message: string, code: string, statusCode: number, hint?: string);
+}
+/**
+ * Thrown when a user does not have enough credits for an operation
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await makeAICall();
+ * } catch (e) {
+ *   if (e instanceof QuotaInsufficientCreditsError) {
+ *     // Prompt user to buy more credits
+ *     showBuyCreditsDialog();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaInsufficientCreditsError extends QuotaError {
+    /** Current balance (if available) */
+    readonly balance: number | undefined;
+    /** Credits required for the operation (if available) */
+    readonly required: number | undefined;
+    constructor(message?: string, options?: {
+        balance?: number;
+        required?: number;
+    });
+}
+/**
+ * Thrown when a user has not connected their Quota account
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const user = await getQuotaUser(config);
+ * } catch (e) {
+ *   if (e instanceof QuotaNotConnectedError) {
+ *     // Redirect to Quota OAuth
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaNotConnectedError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the OAuth access token has expired and cannot be refreshed
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaTokenExpiredError) {
+ *     // Re-authenticate the user
+ *     redirectToQuotaAuth();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaTokenExpiredError extends QuotaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when the Quota API rate limit is exceeded
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await callQuotaAPI();
+ * } catch (e) {
+ *   if (e instanceof QuotaRateLimitError) {
+ *     // Wait and retry
+ *     await delay(e.retryAfter * 1000);
+ *     await callQuotaAPI();
+ *   }
+ * }
+ * ```
+ */
+declare class QuotaRateLimitError extends QuotaError {
+    /** Seconds until the rate limit resets */
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number);
+}
+/**
+ * Maps an HTTP response to the appropriate typed error.
+ * Returns null if the response doesn't represent a known error.
+ *
+ * @internal
+ */
+declare function errorFromResponse(response: Response): Promise<QuotaError | null>;
+
+export { QuotaError as Q, QuotaInsufficientCreditsError as a, QuotaNotConnectedError as b, QuotaTokenExpiredError as c, QuotaRateLimitError as d, errorFromResponse as e };