@isnap/sdk 0.0.0-next.3

package/dist/config.js

@@ -0,0 +1,55 @@
+export const DEFAULTS = {
+    baseUrl: 'https://api.isnap.ai',
+    maxRetries: 3,
+    timeoutMs: 30_000,
+    idempotencyKey: 'auto'
+};
+export function resolveConfig(config) {
+    if (!config || typeof config.apiKey !== 'string') {
+        throw new Error('iSnap SDK: apiKey is required');
+    }
+    const apiKey = config.apiKey.trim();
+    if (apiKey.length === 0) {
+        throw new Error('iSnap SDK: apiKey cannot be empty or whitespace');
+    }
+    return {
+        apiKey,
+        baseUrl: (config.baseUrl ?? DEFAULTS.baseUrl).replace(/\/+$/, ''),
+        maxRetries: validateMaxRetries(config.maxRetries),
+        timeoutMs: validateTimeoutMs(config.timeoutMs),
+        idempotencyKey: config.idempotencyKey ?? DEFAULTS.idempotencyKey,
+        fetch: config.fetch ?? fetch,
+        onRetry: config.onRetry
+    };
+}
+/**
+ * Validate `maxRetries` — must be a non-negative integer. NaN, negatives,
+ * or non-integers (e.g. `Infinity`, `2.5`) would silently break the
+ * `for (let attempt = 0; attempt <= config.maxRetries; attempt++)` loop in
+ * `withRetries` and produce confusing failure modes (zero attempts, or
+ * fractional comparisons). Validate at the boundary so the error surfaces
+ * at construction, not on the first request. Exported for reuse from
+ * per-call `RequestOptions.maxRetries` overrides.
+ */
+export function validateMaxRetries(value) {
+    if (value === undefined)
+        return DEFAULTS.maxRetries;
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`iSnap SDK: maxRetries must be a non-negative integer (got ${String(value)})`);
+    }
+    return value;
+}
+/**
+ * Validate `timeoutMs` — must be a finite positive number. NaN, zero,
+ * negative, or `Infinity` would either abort every request immediately or
+ * never time out at all.
+ */
+export function validateTimeoutMs(value) {
+    if (value === undefined)
+        return DEFAULTS.timeoutMs;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`iSnap SDK: timeoutMs must be a finite positive number (got ${String(value)})`);
+    }
+    return value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,MAAe;CAChC,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO;QACL,MAAM;QACN,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC;QACjD,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC9C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;QAChE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;QAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,CAAC,KAAK,CAAC,GAAG,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,8DAA8D,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+import type { ErrorEnvelope, ErrorIssue } from './types.js';
+export interface APIErrorMeta {
+    status: number;
+    code: string;
+    message: string;
+    traceId: string;
+    requestId: string;
+    retryAfter?: number;
+    issues?: ErrorIssue[];
+}
+export declare class APIError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly traceId: string;
+    readonly requestId: string;
+    readonly retryAfter?: number;
+    readonly issues?: ErrorIssue[];
+    constructor(meta: APIErrorMeta);
+}
+export declare class BadRequestError extends APIError {
+}
+export declare class AuthenticationError extends APIError {
+}
+export declare class PaymentRequiredError extends APIError {
+}
+export declare class PermissionDeniedError extends APIError {
+}
+export declare class NotFoundError extends APIError {
+}
+export declare class ConflictError extends APIError {
+}
+export declare class GoneError extends APIError {
+}
+export declare class UnprocessableEntityError extends APIError {
+}
+export declare class RateLimitError extends APIError {
+}
+export declare class QuotaExceededError extends APIError {
+}
+export declare class InternalServerError extends APIError {
+}
+export declare class ServiceUnavailableError extends APIError {
+}
+export declare class APIConnectionError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class WebhookSignatureError extends Error {
+    constructor(message: string);
+}
+export declare function fromEnvelope(envelope: ErrorEnvelope, traceId: string, requestId: string): APIError;
+//# 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,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;gBAElB,IAAI,EAAE,YAAY;CAU/B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAChD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,oBAAqB,SAAQ,QAAQ;CAAG;AACrD,qBAAa,qBAAsB,SAAQ,QAAQ;CAAG;AACtD,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,SAAU,SAAQ,QAAQ;CAAG;AAC1C,qBAAa,wBAAyB,SAAQ,QAAQ;CAAG;AACzD,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAC/C,qBAAa,kBAAmB,SAAQ,QAAQ;CAAG;AACnD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAUD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,QAAQ,CAqCV"}

package/dist/errors.js

@@ -0,0 +1,100 @@
+export class APIError extends Error {
+    status;
+    code;
+    traceId;
+    requestId;
+    retryAfter;
+    issues;
+    constructor(meta) {
+        super(meta.message);
+        this.name = this.constructor.name;
+        this.status = meta.status;
+        this.code = meta.code;
+        this.traceId = meta.traceId;
+        this.requestId = meta.requestId;
+        this.retryAfter = meta.retryAfter;
+        this.issues = meta.issues;
+    }
+}
+export class BadRequestError extends APIError {
+}
+export class AuthenticationError extends APIError {
+}
+export class PaymentRequiredError extends APIError {
+}
+export class PermissionDeniedError extends APIError {
+}
+export class NotFoundError extends APIError {
+}
+export class ConflictError extends APIError {
+}
+export class GoneError extends APIError {
+}
+export class UnprocessableEntityError extends APIError {
+}
+export class RateLimitError extends APIError {
+}
+export class QuotaExceededError extends APIError {
+}
+export class InternalServerError extends APIError {
+}
+export class ServiceUnavailableError extends APIError {
+}
+export class APIConnectionError extends Error {
+    constructor(message, options) {
+        super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = 'APIConnectionError';
+    }
+}
+export class WebhookSignatureError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WebhookSignatureError';
+    }
+}
+const QUOTA_CODES = new Set([
+    'new_contact_quota_exceeded',
+    'known_contact_quota_exceeded',
+    'total_message_quota_exceeded',
+    'queue_full',
+    'lookup_rate_limit_exceeded'
+]);
+export function fromEnvelope(envelope, traceId, requestId) {
+    const meta = {
+        status: envelope.status,
+        code: envelope.code,
+        message: envelope.message,
+        traceId,
+        requestId,
+        retryAfter: envelope.retry_after,
+        issues: envelope.issues
+    };
+    switch (envelope.status) {
+        case 400:
+            return new BadRequestError(meta);
+        case 401:
+            return new AuthenticationError(meta);
+        case 402:
+            return new PaymentRequiredError(meta);
+        case 403:
+            return new PermissionDeniedError(meta);
+        case 404:
+            return new NotFoundError(meta);
+        case 409:
+            return new ConflictError(meta);
+        case 410:
+            return new GoneError(meta);
+        case 413:
+        case 422:
+            return new UnprocessableEntityError(meta);
+        case 429:
+            return QUOTA_CODES.has(envelope.code) ? new QuotaExceededError(meta) : new RateLimitError(meta);
+        case 500:
+            return new InternalServerError(meta);
+        case 503:
+            return new ServiceUnavailableError(meta);
+        default:
+            return new APIError(meta);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}