@postbrix/sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,361 @@
+/**
+ * Configuration options for PostBrix client
+ */
+interface PostBrixConfig {
+    /** API key for authentication (required) */
+    apiKey: string;
+    /** Base URL for API endpoint (default: https://api.postbrix.com/v1) */
+    baseURL?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum number of retry attempts for transient errors (default: 2) */
+    maxRetries?: number;
+}
+/**
+ * Output format for rendered templates
+ */
+type RenderFormat = "html" | "mjml" | "both";
+/**
+ * Options for render request
+ *
+ * @typeParam TFormat - Desired output format (default: RenderFormat)
+ */
+interface RenderOptions<TFormat extends RenderFormat = RenderFormat> {
+    /** Output format (default: "html") */
+    format?: TFormat;
+}
+/**
+ * Render request body
+ */
+interface RenderRequest {
+    variables?: Record<string, unknown>;
+    format: RenderFormat;
+}
+/**
+ * HTML render response
+ */
+interface HtmlRenderResponse {
+    format: "html";
+    html: string;
+    mjml?: never;
+}
+/**
+ * MJML render response
+ */
+interface MjmlRenderResponse {
+    format: "mjml";
+    mjml: string;
+    html?: never;
+}
+/**
+ * Both formats render response
+ */
+interface BothFormatsRenderResponse {
+    format: "both";
+    html: string;
+    mjml: string;
+}
+/**
+ * Render response discriminated union
+ */
+type RenderResponse = HtmlRenderResponse | MjmlRenderResponse | BothFormatsRenderResponse;
+/**
+ * Resolves concrete return type based on requested format:
+ * - "html" -> HtmlRenderResponse (guaranteed .html: string)
+ * - "mjml" -> MjmlRenderResponse (guaranteed .mjml: string)
+ * - "both" -> BothFormatsRenderResponse (guaranteed .html: string, .mjml: string)
+ * - RenderFormat / union -> RenderResponse (discriminated union)
+ */
+type RenderResult<TFormat extends RenderFormat = "html"> = [
+    TFormat
+] extends ["mjml"] ? MjmlRenderResponse : [TFormat] extends ["both"] ? BothFormatsRenderResponse : [TFormat] extends ["html"] ? HtmlRenderResponse : RenderResponse;
+/**
+ * API error response from server
+ */
+interface ApiErrorResponse {
+    message?: string;
+    error?: string;
+    code?: string;
+    statusCode?: number;
+    requestId?: string;
+    details?: unknown;
+}
+/**
+ * HTTP response wrapper
+ */
+interface HttpResponse<T> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+}
+
+/**
+ * PostBrix SDK Client
+ *
+ * Main entry point for interacting with the PostBrix Template Render API.
+ * Provides zero-dependency, strongly typed template rendering with built-in
+ * exponential jitter retries, timeout management, and comprehensive error handling.
+ */
+declare class PostBrix {
+    private readonly apiKey;
+    private readonly baseURL;
+    private readonly timeout;
+    private readonly maxRetries;
+    private static readonly DEFAULT_BASE_URL;
+    private static readonly DEFAULT_TIMEOUT;
+    private static readonly DEFAULT_MAX_RETRIES;
+    /**
+     * Initialize a new PostBrix SDK client instance.
+     *
+     * @param config - Configuration options for the client
+     * @param config.apiKey - PostBrix API key for authentication (starts with `pb_live_` or `pb_test_`)
+     * @param config.baseURL - Base URL for the PostBrix API (default: `https://api.postbrix.com/v1`)
+     * @param config.timeout - Request timeout in milliseconds (default: `30000`)
+     * @param config.maxRetries - Maximum retry attempts for transient errors (default: `2`)
+     *
+     * @example
+     * ```ts
+     * import { PostBrix } from "@postbrix/sdk";
+     *
+     * // Standard initialization
+     * const postbrix = new PostBrix({
+     *   apiKey: process.env.POSTBRIX_API_KEY!,
+     * });
+     *
+     * // Custom timeout and retries
+     * const postbrix = new PostBrix({
+     *   apiKey: "pb_live_xxxxxxxxxxxxxxxxxxxxxxxx",
+     *   baseURL: "https://api.postbrix.com/v1",
+     *   timeout: 10000,
+     *   maxRetries: 3,
+     * });
+     * ```
+     *
+     * @throws {PostBrixValidationError} If any configuration parameter is invalid
+     */
+    constructor(config: PostBrixConfig);
+    /**
+     * Validate configuration options in detail
+     *
+     * @param config - Configuration object to validate
+     * @throws {PostBrixValidationError} If configuration is missing or invalid
+     */
+    private validateConfig;
+    /**
+     * Returns active client configuration with sensitive secrets securely masked.
+     * Useful for debugging, logging, and environment verification.
+     *
+     * @returns Read-only sanitized configuration object
+     *
+     * @example
+     * ```ts
+     * const config = postbrix.getConfig();
+     * console.log(config);
+     * // { baseURL: 'https://api.postbrix.com/v1', timeout: 30000, maxRetries: 2, apiKey: 'pb_live...[REDACTED]' }
+     * ```
+     */
+    getConfig(): Readonly<{
+        baseURL: string;
+        timeout: number;
+        maxRetries: number;
+        apiKey: string;
+    }>;
+    /**
+     * Render an email template with dynamic variables.
+     *
+     * @typeParam TVariables - Shape of dynamic variables passed to the template
+     * @typeParam TFormat - Desired output format: "html" (default), "mjml", or "both"
+     *
+     * @param templateId - Template identifier or slug (e.g. "welcome-email")
+     * @param variables - Key-value variables to substitute into template tags (must be JSON-serializable)
+     * @param options - Configuration options for rendering (e.g. `{ format: "html" }`)
+     * @returns Promise resolving to the rendered template output matching the requested format
+     *
+     * @example
+     * ```ts
+     * // 1. Render HTML (default - returns { format: "html", html: string })
+     * const result = await postbrix.render("welcome-email", { name: "Alex" });
+     * console.log(result.html);
+     *
+     * // 2. Render MJML (returns { format: "mjml", mjml: string })
+     * const mjmlResult = await postbrix.render("welcome-email", { name: "Alex" }, { format: "mjml" });
+     * console.log(mjmlResult.mjml);
+     *
+     * // 3. Render Both (returns { format: "both", html: string, mjml: string })
+     * const bothResult = await postbrix.render("welcome-email", { name: "Alex" }, { format: "both" });
+     * console.log(bothResult.html, bothResult.mjml);
+     * ```
+     *
+     * @throws {PostBrixValidationError} If templateId, variables, format, or circular data are invalid
+     * @throws {PostBrixAuthenticationError} If the API key is missing or invalid (401)
+     * @throws {PostBrixForbiddenError} If API key lacks permissions (403)
+     * @throws {PostBrixNotFoundError} If templateId does not exist (404)
+     * @throws {PostBrixRateLimitError} If rate limit is exceeded (429)
+     * @throws {PostBrixServerError} If server encounters an internal error (500, 502, 503, 504)
+     * @throws {PostBrixTimeoutError} If request times out
+     * @throws {PostBrixNetworkError} If network connection fails
+     */
+    render<TVariables extends Record<string, unknown> = Record<string, unknown>, TFormat extends RenderFormat = "html">(templateId: string, variables?: TVariables, options?: RenderOptions<TFormat>): Promise<RenderResult<TFormat>>;
+    /**
+     * Internal request method with retry logic
+     */
+    private request;
+    /**
+     * Execute a single request
+     */
+    private executeRequest;
+    /**
+     * Build request headers
+     */
+    private buildHeaders;
+    /**
+     * Handle successful response with schema validation and backend unwrap
+     */
+    private handleSuccessResponse;
+    /**
+     * Handle error response
+     */
+    private handleErrorResponse;
+    /**
+     * Determine if error is retryable
+     */
+    private isRetryableError;
+}
+
+/**
+ * Base error class for all PostBrix SDK errors
+ */
+declare class PostBrixError extends Error {
+    readonly statusCode?: number;
+    readonly requestId?: string;
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly details?: unknown;
+    readonly cause?: Error;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        retryable?: boolean;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when request times out
+ */
+declare class PostBrixTimeoutError extends PostBrixError {
+    constructor(timeoutMs: number, options?: {
+        requestId?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown for network issues
+ */
+declare class PostBrixNetworkError extends PostBrixError {
+    constructor(message: string, options?: {
+        requestId?: string;
+        retryable?: boolean;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown for validation issues
+ */
+declare class PostBrixValidationError extends PostBrixError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown for authentication/authorization issues
+ */
+declare class PostBrixAuthError extends PostBrixError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when rate limit is exceeded
+ */
+declare class PostBrixLimitError extends PostBrixError {
+    readonly retryAfter?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        retryAfter?: number;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when template is not found
+ */
+declare class PostBrixTemplateError extends PostBrixError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when API returns a malformed response
+ */
+declare class PostBrixResponseError extends PostBrixError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when access is forbidden (403)
+ */
+declare class PostBrixForbiddenError extends PostBrixAuthError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown for server-side failures (5xx)
+ */
+declare class PostBrixServerError extends PostBrixError {
+    constructor(message: string, options?: {
+        statusCode?: number;
+        requestId?: string;
+        code?: string;
+        retryable?: boolean;
+        details?: unknown;
+        cause?: Error;
+    });
+}
+/** Canonical Aliases for Error Classes */
+declare const PostBrixAuthenticationError: typeof PostBrixAuthError;
+type PostBrixAuthenticationError = PostBrixAuthError;
+declare const PostBrixRateLimitError: typeof PostBrixLimitError;
+type PostBrixRateLimitError = PostBrixLimitError;
+declare const PostBrixNotFoundError: typeof PostBrixTemplateError;
+type PostBrixNotFoundError = PostBrixTemplateError;
+
+declare const SDK_VERSION = "1.0.0";
+declare const VERSION = "1.0.0";
+
+export { type ApiErrorResponse, type BothFormatsRenderResponse, type HtmlRenderResponse, type HttpResponse, type MjmlRenderResponse, PostBrix, PostBrixAuthError, PostBrixAuthenticationError, type PostBrixConfig, PostBrixError, PostBrixForbiddenError, PostBrixLimitError, PostBrixNetworkError, PostBrixNotFoundError, PostBrixRateLimitError, PostBrixResponseError, PostBrixServerError, PostBrixTemplateError, PostBrixTimeoutError, PostBrixValidationError, type RenderFormat, type RenderOptions, type RenderRequest, type RenderResponse, type RenderResult, SDK_VERSION, VERSION };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+var c=class extends Error{statusCode;requestId;code;retryable;details;cause;constructor(e,t){super(e),this.name="PostBrixError",this.statusCode=t?.statusCode,this.requestId=t?.requestId,this.code=t?.code??"POSTBRIX_ERROR",this.retryable=t?.retryable??false,this.details=t?.details,this.cause=t?.cause,Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor),Object.setPrototypeOf(this,new.target.prototype);}},y=class r extends c{constructor(e,t){super(`Request timed out after ${e}ms`,{code:"POSTBRIX_TIMEOUT",requestId:t?.requestId,retryable:true,cause:t?.cause}),this.name="PostBrixTimeoutError",Object.setPrototypeOf(this,r.prototype);}},b=class r extends c{constructor(e,t){super(e,{code:"POSTBRIX_NETWORK_ERROR",requestId:t?.requestId,retryable:t?.retryable??true,cause:t?.cause}),this.name="PostBrixNetworkError",Object.setPrototypeOf(this,r.prototype);}},d=class r extends c{constructor(e,t){super(e,{statusCode:t?.statusCode??400,requestId:t?.requestId,code:t?.code??"POSTBRIX_VALIDATION_ERROR",retryable:false,details:t?.details,cause:t?.cause}),this.name="PostBrixValidationError",Object.setPrototypeOf(this,r.prototype);}},E=class r extends c{constructor(e,t){let n=t?.statusCode??401,o=n===403?"FORBIDDEN":"POSTBRIX_AUTH_ERROR";super(e,{statusCode:n,requestId:t?.requestId,code:t?.code??o,retryable:false,details:t?.details,cause:t?.cause}),this.name="PostBrixAuthError",Object.setPrototypeOf(this,r.prototype);}},R=class r extends c{retryAfter;constructor(e,t){super(e,{statusCode:t?.statusCode??429,requestId:t?.requestId,code:t?.code??"POSTBRIX_LIMIT_ERROR",retryable:true,details:t?.details,cause:t?.cause}),this.name="PostBrixLimitError",this.retryAfter=t?.retryAfter,Object.setPrototypeOf(this,r.prototype);}},h=class r extends c{constructor(e,t){super(e,{statusCode:t?.statusCode??404,requestId:t?.requestId,code:t?.code??"POSTBRIX_TEMPLATE_ERROR",retryable:false,details:t?.details,cause:t?.cause}),this.name="PostBrixTemplateError",Object.setPrototypeOf(this,r.prototype);}},l=class r extends c{constructor(e,t){super(e,{statusCode:t?.statusCode??502,requestId:t?.requestId,code:t?.code??"INVALID_RESPONSE",retryable:false,details:t?.details,cause:t?.cause}),this.name="PostBrixResponseError",Object.setPrototypeOf(this,r.prototype);}},g=class r extends E{constructor(e,t){super(e,{statusCode:t?.statusCode??403,requestId:t?.requestId,code:t?.code??"FORBIDDEN",details:t?.details,cause:t?.cause}),this.name="PostBrixForbiddenError",Object.setPrototypeOf(this,r.prototype);}},f=class r extends c{constructor(e,t){super(e,{statusCode:t?.statusCode??500,requestId:t?.requestId,code:t?.code??"SERVER_ERROR",retryable:t?.retryable??true,details:t?.details,cause:t?.cause}),this.name="PostBrixServerError",Object.setPrototypeOf(this,r.prototype);}},_=E,j=R,L=h;function P(r,e,t){let n=typeof t=="string"?{requestId:t}:t,{requestId:o,code:a,details:s,retryAfter:i}=n??{};switch(r){case 400:return new d(e,{statusCode:r,requestId:o,code:a??"VALIDATION_ERROR",details:s});case 401:return new E(e,{statusCode:r,requestId:o,code:a??"INVALID_API_KEY",details:s});case 403:return new g(e,{statusCode:r,requestId:o,code:a??"FORBIDDEN",details:s});case 404:return new h(e,{statusCode:r,requestId:o,code:a??"TEMPLATE_NOT_FOUND",details:s});case 429:return new R(e,{statusCode:r,requestId:o,code:a??"RATE_LIMIT_EXCEEDED",retryAfter:i,details:s});case 500:return new f(e,{statusCode:500,requestId:o,code:a??"INTERNAL_SERVER_ERROR",retryable:true,details:s});case 502:return new f(e,{statusCode:502,requestId:o,code:a??"BAD_GATEWAY",retryable:true,details:s});case 503:return new f(e,{statusCode:503,requestId:o,code:a??"SERVICE_UNAVAILABLE",retryable:true,details:s});case 504:return new f(e,{statusCode:504,requestId:o,code:a??"GATEWAY_TIMEOUT",retryable:true,details:s});default:return r>=500?new f(e,{statusCode:r,requestId:o,code:a??"SERVER_ERROR",retryable:true,details:s}):new c(e,{statusCode:r,requestId:o,code:a??"POSTBRIX_ERROR",retryable:false,details:s})}}function T(r,e){if(typeof r!="string"||r.trim().length===0)throw new d(`${e} must be a non-empty string`)}function C(r,e){if(typeof r!="number"||Number.isNaN(r)||r<=0)throw new d(`${e} must be greater than 0`)}function S(r,e){if(typeof r!="number"||Number.isNaN(r)||r<0||!Number.isInteger(r))throw new d(`${e} must be a non-negative integer`)}function q(r){let n=500*Math.pow(2,r),o=Math.random()*100;return Math.min(n+o,1e4)}function B(r){if(!r)return null;let e=r.trim();if(!e)return null;let t=Number(e);if(!Number.isNaN(t)&&t>=0)return t*1e3;let n=Date.parse(e);if(!Number.isNaN(n)){let o=n-Date.now();return Math.max(0,o)}return null}function D(r){return [429,502,503,504].includes(r)}function N(r){return new Promise(e=>setTimeout(e,r))}function A(r,e){let t=r.replace(/bearer\s+[a-zA-Z0-9_.-]+/gi,"Bearer [REDACTED]").replace(/pb_(?:live|test)_[a-zA-Z0-9_-]+/gi,"pb_[REDACTED]").replace(/sk_(?:live|test)_[a-zA-Z0-9_-]+/gi,"sk_[REDACTED]").replace(/api[_-]?key[=:]\s*[a-zA-Z0-9_.-]+/gi,"apiKey=[REDACTED]").replace(/authorization[=:]\s*[^\s,]+/gi,"authorization=[REDACTED]");return e&&e.trim().length>0&&(t=t.split(e.trim()).join("[REDACTED]")),t}function k(r){if(!r)return {};if(typeof r!="object"||Array.isArray(r))throw new d("Template variables must be an object with string keys");let e=new WeakSet;function t(n,o){if(n==null)return n;if(typeof n=="bigint")throw new d(`Unsupported variable type 'bigint' at '${o}'. Template variables must be JSON-serializable.`);if(typeof n=="function")throw new d(`Unsupported variable type 'function' at '${o}'. Template variables must be JSON-serializable.`);if(typeof n=="symbol")throw new d(`Unsupported variable type 'symbol' at '${o}'. Template variables must be JSON-serializable.`);if(typeof n!="object")return n;if(n instanceof Map||n instanceof Set)throw new d(`Unsupported variable collection '${n.constructor.name}' at '${o}'. Template variables must be JSON-serializable.`);if(e.has(n))throw new d(`Circular reference detected at '${o}'. Template variables must be JSON-serializable.`);if(e.add(n),Array.isArray(n)){let i=n.map((u,m)=>t(u,`${o}[${m}]`));return e.delete(n),i}if(n instanceof Date)return e.delete(n),new Date(n.getTime());if(n instanceof RegExp)return e.delete(n),new RegExp(n.source,n.flags);let a=n,s={};for(let i of Object.keys(a)){let u=o?`${o}.${i}`:i;s[i]=t(a[i],u);}return e.delete(n),s}return t(r,"")}var I="1.0.0",U=I;var O=class r{apiKey;baseURL;timeout;maxRetries;static DEFAULT_BASE_URL="https://api.postbrix.com/v1";static DEFAULT_TIMEOUT=3e4;static DEFAULT_MAX_RETRIES=2;constructor(e){this.validateConfig(e),this.apiKey=e.apiKey.trim(),this.baseURL=(e.baseURL??r.DEFAULT_BASE_URL).trim().replace(/\/+$/,""),this.timeout=e.timeout??r.DEFAULT_TIMEOUT,this.maxRetries=e.maxRetries??r.DEFAULT_MAX_RETRIES;}validateConfig(e){if(!e||typeof e!="object")throw new d("Configuration object is required. Usage: new PostBrix({ apiKey: 'pb_live_...' })");T(e.apiKey,"apiKey"),e.baseURL!==void 0&&e.baseURL!==null&&T(e.baseURL,"baseURL"),e.timeout!==void 0&&e.timeout!==null&&C(e.timeout,"timeout"),e.maxRetries!==void 0&&e.maxRetries!==null&&S(e.maxRetries,"maxRetries");}getConfig(){let e=this.apiKey.length>8?`${this.apiKey.slice(0,7)}...[REDACTED]`:"[REDACTED]";return Object.freeze({baseURL:this.baseURL,timeout:this.timeout,maxRetries:this.maxRetries,apiKey:e})}async render(e,t,n){T(e,"templateId");let o=e.trim();if(o.length===0)throw new d("templateId must be a non-empty string");let a=n?.format??"html";if(a!=="html"&&a!=="mjml"&&a!=="both")throw new d(`Invalid format '${String(a)}'. Must be 'html', 'mjml', or 'both'.`);let s=k(t),i=`${this.baseURL}/templates/${encodeURIComponent(o)}/render`,u={variables:s,format:a};return await this.request(i,{method:"POST",body:JSON.stringify(u)},a)}async request(e,t={},n="html"){let o;for(let a=0;a<=this.maxRetries;a++)try{return await this.executeRequest(e,t,n)}catch(s){if(o=s instanceof Error?s:new Error(String(s)),!this.isRetryableError(s)||a===this.maxRetries)throw s;let i;s instanceof R&&typeof s.retryAfter=="number"&&s.retryAfter>=0?i=s.retryAfter:i=q(a),await N(i);}throw o??new c("Request failed after max retries")}async executeRequest(e,t={},n="html"){let o=new AbortController,a=setTimeout(()=>o.abort(),this.timeout);try{let s=this.buildHeaders(),i=t.method??"GET",u=await fetch(e,{method:i,headers:s,body:t.body,signal:o.signal});return u.ok?await this.handleSuccessResponse(u,n):await this.handleErrorResponse(u)}catch(s){if(s instanceof Error&&s.name==="AbortError"||typeof DOMException<"u"&&s instanceof DOMException&&s.name==="AbortError")throw new y(this.timeout,{cause:s instanceof Error?s:void 0});if(s instanceof c)throw s;let i=s instanceof Error?s.message:String(s),u=A(i,this.apiKey);throw new b(`Network request failed: ${u}`,{cause:s instanceof Error?s:void 0,retryable:true})}finally{clearTimeout(a);}}buildHeaders(){return {Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json",Accept:"application/json","User-Agent":`postbrix-sdk/${I}`}}async handleSuccessResponse(e,t){let n=e.headers.get("x-request-id")??void 0,o;try{o=await e.json();}catch(p){throw new l("Failed to parse response body as JSON",{statusCode:e.status,requestId:n,cause:p instanceof Error?p:void 0})}if(!o||typeof o!="object")throw new l("Server returned an invalid response structure",{statusCode:e.status,requestId:n});let a=o,s=a.data&&typeof a.data=="object"?a.data:a,i=typeof s.html=="string"?s.html:void 0,u=typeof s.mjml=="string"?s.mjml:void 0,m=typeof s.format=="string"?s.format:t;if(m==="html"){if(typeof i!="string")throw new l("Server response missing required 'html' string field for format 'html'",{statusCode:e.status,requestId:n,details:o});return {format:"html",html:i}}if(m==="mjml"){if(typeof u!="string")throw new l("Server response missing required 'mjml' string field for format 'mjml'",{statusCode:e.status,requestId:n,details:o});return {format:"mjml",mjml:u}}if(m==="both"){if(typeof i!="string"||typeof u!="string")throw new l("Server response missing required 'html' or 'mjml' string fields for format 'both'",{statusCode:e.status,requestId:n,details:o});return {format:"both",html:i,mjml:u}}throw new l(`Unexpected response format '${String(m)}'`,{statusCode:e.status,requestId:n,details:o})}async handleErrorResponse(e){let t=e.headers.get("x-request-id")??void 0,n=e.headers.get("retry-after"),o=B(n)??void 0,a=null,s=null;try{a=await e.json();}catch{try{s=await e.text();}catch{}}let i=t??a?.requestId??void 0,u=a?.message??(typeof a?.error=="string"?a.error:void 0);u||(s&&s.trim().length>0&&!s.trim().startsWith("<")?u=s.trim():u=`HTTP ${e.status}: ${e.statusText||"Error"}`);let m=A(u,this.apiKey),p=a?.code;throw !p&&typeof a?.error=="string"&&/^[A-Z0-9_-]+$/.test(a.error)&&(p=a.error),P(e.status,m,{requestId:i,code:p,details:a?.details,retryAfter:o})}isRetryableError(e){if(e instanceof c){if(e.retryable)return  true;let t=e.statusCode;return t!==void 0&&D(t)}return e instanceof y||e instanceof b}};
+export{O as PostBrix,E as PostBrixAuthError,_ as PostBrixAuthenticationError,c as PostBrixError,g as PostBrixForbiddenError,R as PostBrixLimitError,b as PostBrixNetworkError,L as PostBrixNotFoundError,j as PostBrixRateLimitError,l as PostBrixResponseError,f as PostBrixServerError,h as PostBrixTemplateError,y as PostBrixTimeoutError,d as PostBrixValidationError,I as SDK_VERSION,U as VERSION};

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@postbrix/sdk",
+  "version": "1.0.0",
+  "description": "Official PostBrix SDK for Node.js, Bun, Deno, Cloudflare Workers, and Vercel Edge Runtime",
+  "type": "commonjs",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "postbrix",
+    "email",
+    "templates",
+    "api",
+    "sdk",
+    "typescript",
+    "javascript"
+  ],
+  "author": "PostBrix Team <support@postbrix.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/postbrix/postbrix-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/postbrix/postbrix-sdk/issues"
+  },
+  "homepage": "https://github.com/postbrix/postbrix-sdk",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --max-warnings 0",
+    "typecheck": "tsc --noEmit",
+    "test": "VITE_CJS_IGNORE_WARNING=true vitest run",
+    "test:watch": "VITE_CJS_IGNORE_WARNING=true vitest",
+    "test:coverage": "VITE_CJS_IGNORE_WARNING=true vitest run --coverage",
+    "test:integration": "VITE_CJS_IGNORE_WARNING=true vitest run tests/integration.test.ts",
+    "prepublishOnly": "npm run clean && npm run lint && npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^1.1.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  }
+}