@binalyze/air-sdk 5.22.4 → 5.24.3

package/dist/sdk/typescript-axios-v2/types.gen.js

@@ -0,0 +1,5 @@
+"use strict";
+// @ts-nocheck
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.gen.js.map

package/dist/sdk/typescript-axios-v2/types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.gen.js","sourceRoot":"","sources":["../../../src/sdk/typescript-axios-v2/types.gen.ts"],"names":[],"mappings":";AAAA,cAAc;AACd,qDAAqD"}

package/dist/utils/index.d.ts

@@ -2,3 +2,6 @@ export * from './utils';
 export * from './error-helpers';
 export * from './builders';
 export * from './result';
+export * from './page-iterator';
+export * from './retry';
+export * from './typed-errors';

package/dist/utils/index.js

@@ -18,4 +18,7 @@ __exportStar(require("./utils"), exports);
 __exportStar(require("./error-helpers"), exports);
 __exportStar(require("./builders"), exports);
 __exportStar(require("./result"), exports);
+__exportStar(require("./page-iterator"), exports);
+__exportStar(require("./retry"), exports);
+__exportStar(require("./typed-errors"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,kDAAgC;AAChC,6CAA2B;AAC3B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,kDAAgC;AAChC,6CAA2B;AAC3B,2CAAyB;AACzB,kDAAgC;AAChC,0CAAwB;AACxB,iDAA+B"}

package/dist/utils/page-iterator.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Async iterator over v2 offset-paginated endpoints (Plan PR 18, design
+ * §5.6): requests increment pageNumber; the response's IOffsetPageV2 result
+ * carries currentPage/nextPage; iteration ends when nextPage is null. A
+ * non-advancing nextPage throws instead of looping forever.
+ */
+export interface OffsetPageLike<T> {
+    entities: T[];
+    currentPage: number;
+    nextPage: number | null;
+}
+export declare function iterateOffsetPages<T>(fetchPage: (pageNumber: number) => Promise<OffsetPageLike<T>>, startPage?: number): AsyncGenerator<T, void, undefined>;

package/dist/utils/page-iterator.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterateOffsetPages = iterateOffsetPages;
+async function* iterateOffsetPages(fetchPage, startPage = 1) {
+    let pageNumber = startPage;
+    while (pageNumber !== null) {
+        const page = await fetchPage(pageNumber);
+        yield* page.entities;
+        if (page.nextPage === null) {
+            return;
+        }
+        // The page shape comes from an unvalidated envelope cast, so a malformed
+        // response can carry undefined/NaN here; both would slip past a plain
+        // `<=` guard (undefined/NaN comparisons are false) and loop forever.
+        if (typeof page.nextPage !== 'number' ||
+            !Number.isFinite(page.nextPage) ||
+            page.nextPage <= pageNumber) {
+            throw new Error(`Offset pagination did not advance: requested page ${pageNumber}, nextPage ${page.nextPage}.`);
+        }
+        pageNumber = page.nextPage;
+    }
+}
+//# sourceMappingURL=page-iterator.js.map

package/dist/utils/page-iterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-iterator.js","sourceRoot":"","sources":["../../src/utils/page-iterator.ts"],"names":[],"mappings":";;AAYA,gDAyBC;AAzBM,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACvC,SAA6D,EAC7D,SAAS,GAAG,CAAC;IAEb,IAAI,UAAU,GAAkB,SAAS,CAAC;IAC1C,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QACzC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,yEAAyE;QACzE,sEAAsE;QACtE,qEAAqE;QACrE,IACE,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;YACjC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC/B,IAAI,CAAC,QAAQ,IAAI,UAAU,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,qDAAqD,UAAU,cAAc,IAAI,CAAC,QAAQ,GAAG,CAC9F,CAAC;QACJ,CAAC;QACD,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Response-status retry helper for the v2 SDK (Plan PR 18). The default
+ * retryable set is the design-reference `x-retry-on` list (§5.8); the spec
+ * does not carry the extension yet, so the list lives here, overridable via
+ * options. Retry-After (delta-seconds or HTTP-date) wins over backoff.
+ */
+export declare const DEFAULT_RETRYABLE_STATUSES: readonly number[];
+/**
+ * Safe set for non-idempotent operations: the v2 API has no idempotency keys,
+ * so a 5xx after the server-side effect must not re-send the mutation. 408
+ * (never reached the handler) and 429 (rejected before execution) are the
+ * only statuses that cannot have caused a partial effect.
+ */
+export declare const MUTATION_RETRYABLE_STATUSES: readonly number[];
+export interface RetryableResponse {
+    status: number;
+    headers?: Record<string, unknown>;
+}
+export interface RetryOptions {
+    maxAttempts?: number;
+    retryableStatuses?: readonly number[];
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+export declare function parseRetryAfterMs(value: unknown, now?: () => number): number | undefined;
+export declare function withRetry<T extends RetryableResponse>(send: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export declare function readRetryAfterHeader(headers: Record<string, unknown> | undefined): string | undefined;

package/dist/utils/retry.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MUTATION_RETRYABLE_STATUSES = exports.DEFAULT_RETRYABLE_STATUSES = void 0;
+exports.parseRetryAfterMs = parseRetryAfterMs;
+exports.withRetry = withRetry;
+exports.readRetryAfterHeader = readRetryAfterHeader;
+/**
+ * Response-status retry helper for the v2 SDK (Plan PR 18). The default
+ * retryable set is the design-reference `x-retry-on` list (§5.8); the spec
+ * does not carry the extension yet, so the list lives here, overridable via
+ * options. Retry-After (delta-seconds or HTTP-date) wins over backoff.
+ */
+exports.DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
+/**
+ * Safe set for non-idempotent operations: the v2 API has no idempotency keys,
+ * so a 5xx after the server-side effect must not re-send the mutation. 408
+ * (never reached the handler) and 429 (rejected before execution) are the
+ * only statuses that cannot have caused a partial effect.
+ */
+exports.MUTATION_RETRYABLE_STATUSES = [408, 429];
+function parseRetryAfterMs(value, now = Date.now) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        return undefined;
+    }
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return seconds * 1000;
+    }
+    const dateMs = Date.parse(value);
+    if (Number.isNaN(dateMs)) {
+        return undefined;
+    }
+    return Math.max(0, dateMs - now());
+}
+async function withRetry(send, options = {}) {
+    const maxAttempts = options.maxAttempts ?? 3;
+    const retryableStatuses = options.retryableStatuses ?? exports.DEFAULT_RETRYABLE_STATUSES;
+    const baseDelayMs = options.baseDelayMs ?? 500;
+    const maxDelayMs = options.maxDelayMs ?? 30_000;
+    const sleep = options.sleep ?? defaultSleep;
+    let response = await send();
+    for (let attempt = 1; attempt < maxAttempts && retryableStatuses.includes(response.status); attempt += 1) {
+        const retryAfterMs = parseRetryAfterMs(readHeader(response.headers, 'retry-after'), options.now);
+        // Retry-After is honored exactly (server instruction) — maxDelayMs only
+        // caps our own computed backoff, never the server's explicit delay, or a
+        // 429/503 with a long Retry-After would be retried too early. Pure backoff
+        // gets half-jitter so a fleet of clients does not retry in lockstep.
+        const backoffMs = baseDelayMs * 2 ** (attempt - 1);
+        const jitteredBackoffMs = backoffMs / 2 + Math.random() * (backoffMs / 2);
+        const delayMs = retryAfterMs ?? Math.min(jitteredBackoffMs, maxDelayMs);
+        await sleep(delayMs);
+        response = await send();
+    }
+    return response;
+}
+function readRetryAfterHeader(headers) {
+    const value = readHeader(headers, 'retry-after');
+    return typeof value === 'string' ? value : undefined;
+}
+function readHeader(headers, name) {
+    if (!headers) {
+        return undefined;
+    }
+    const key = Object.keys(headers).find((header) => header.toLowerCase() === name);
+    return key === undefined ? undefined : headers[key];
+}
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/typed-errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Typed v2 error layer (Plan PR 18): a discriminated union over the stable
+ * `code` field inside the v2 envelope's errors[]. Codes mirror
+ * V2_ERROR_CODE_BY_HTTP_STATUS in src/shared/filters/v2-exception.filter.ts;
+ * unknown codes and non-envelope payloads degrade to the UNKNOWN variant.
+ */
+export declare const V2_ERROR_CODES: readonly ["BAD_REQUEST", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "VALIDATION_ERROR", "RATE_LIMITED", "INTERNAL_ERROR", "SERVICE_UNAVAILABLE"];
+export type V2ErrorCode = (typeof V2_ERROR_CODES)[number];
+export interface V2ApiErrorEntry {
+    code: string;
+    message: string;
+    field?: string;
+    details?: Record<string, unknown>;
+}
+export interface V2Envelope<T = unknown> {
+    success: boolean;
+    statusCode: number;
+    errors: V2ApiErrorEntry[];
+    result: T | null;
+}
+interface BaseTypedV2Error {
+    statusCode: number;
+    message: string;
+    errors: V2ApiErrorEntry[];
+}
+export type TypedV2Error = (BaseTypedV2Error & {
+    code: 'VALIDATION_ERROR';
+    fieldErrors: V2ApiErrorEntry[];
+}) | (BaseTypedV2Error & {
+    code: 'RATE_LIMITED';
+    retryAfterMs?: number;
+}) | (BaseTypedV2Error & {
+    code: Exclude<V2ErrorCode, 'VALIDATION_ERROR' | 'RATE_LIMITED'>;
+}) | (BaseTypedV2Error & {
+    code: 'UNKNOWN';
+});
+export declare class AirV2Error extends Error {
+    readonly typed: TypedV2Error;
+    constructor(typed: TypedV2Error);
+}
+export declare function isV2Envelope(value: unknown): value is V2Envelope;
+export declare function classifyV2Error(payload: unknown, fallbackStatusCode: number, retryAfterHeader?: string): TypedV2Error;
+export declare function unwrapV2Envelope<T>(payload: unknown, fallbackStatusCode?: number, retryAfterHeader?: string): T;
+export {};

package/dist/utils/typed-errors.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirV2Error = exports.V2_ERROR_CODES = void 0;
+exports.isV2Envelope = isV2Envelope;
+exports.classifyV2Error = classifyV2Error;
+exports.unwrapV2Envelope = unwrapV2Envelope;
+const retry_1 = require("./retry");
+/**
+ * Typed v2 error layer (Plan PR 18): a discriminated union over the stable
+ * `code` field inside the v2 envelope's errors[]. Codes mirror
+ * V2_ERROR_CODE_BY_HTTP_STATUS in src/shared/filters/v2-exception.filter.ts;
+ * unknown codes and non-envelope payloads degrade to the UNKNOWN variant.
+ */
+exports.V2_ERROR_CODES = [
+    'BAD_REQUEST',
+    'UNAUTHORIZED',
+    'FORBIDDEN',
+    'NOT_FOUND',
+    'CONFLICT',
+    'VALIDATION_ERROR',
+    'RATE_LIMITED',
+    'INTERNAL_ERROR',
+    'SERVICE_UNAVAILABLE',
+];
+class AirV2Error extends Error {
+    constructor(typed) {
+        super(typed.message);
+        this.name = 'AirV2Error';
+        this.typed = typed;
+    }
+}
+exports.AirV2Error = AirV2Error;
+function isV2Envelope(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.success === 'boolean' &&
+        typeof candidate.statusCode === 'number' &&
+        Array.isArray(candidate.errors) &&
+        'result' in candidate);
+}
+function classifyV2Error(payload, fallbackStatusCode, retryAfterHeader) {
+    if (!isV2Envelope(payload)) {
+        return {
+            code: 'UNKNOWN',
+            statusCode: fallbackStatusCode,
+            message: 'Response is not a v2 envelope.',
+            errors: [],
+        };
+    }
+    const errors = payload.errors;
+    const primaryCode = errors[0]?.code;
+    const message = errors[0]?.message ?? `Request failed with status ${payload.statusCode}.`;
+    const base = { statusCode: payload.statusCode, message, errors };
+    if (primaryCode === 'VALIDATION_ERROR') {
+        return { ...base, code: 'VALIDATION_ERROR', fieldErrors: errors };
+    }
+    if (primaryCode === 'RATE_LIMITED') {
+        return { ...base, code: 'RATE_LIMITED', retryAfterMs: (0, retry_1.parseRetryAfterMs)(retryAfterHeader) };
+    }
+    if (isKnownErrorCode(primaryCode)) {
+        return { ...base, code: primaryCode };
+    }
+    return { ...base, code: 'UNKNOWN' };
+}
+function unwrapV2Envelope(payload, fallbackStatusCode = 0, retryAfterHeader) {
+    if (!isV2Envelope(payload)) {
+        throw new AirV2Error(classifyV2Error(payload, fallbackStatusCode, retryAfterHeader));
+    }
+    if (!payload.success) {
+        throw new AirV2Error(classifyV2Error(payload, payload.statusCode, retryAfterHeader));
+    }
+    return payload.result;
+}
+function isKnownErrorCode(code) {
+    return (code !== undefined &&
+        code !== 'VALIDATION_ERROR' &&
+        code !== 'RATE_LIMITED' &&
+        exports.V2_ERROR_CODES.includes(code));
+}
+//# sourceMappingURL=typed-errors.js.map

package/dist/utils/typed-errors.js.map

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

package/dist/v2/AIR.d.ts

@@ -0,0 +1,56 @@
+import { sdkV2 } from '../generated/bindings-v2';
+import { RetryOptions } from '../utils/retry';
+interface V2AxiosResponse {
+    status: number;
+    headers?: Record<string, unknown>;
+    data?: unknown;
+}
+export interface RequestOptions {
+    /**
+     * Marks the wrapped operation as safe to re-send after a 5xx (GETs and
+     * other side-effect-free calls). Without it only 408/429 are retried: the
+     * v2 API has no idempotency keys, so a mutation that failed mid-flight
+     * must not be re-executed.
+     */
+    idempotent?: boolean;
+}
+type SdkOperations = typeof sdkV2;
+/**
+ * v2-aware AIR client (Plan PR 18). Exposes the full generated operation
+ * surface as `operations`, plus `request` (retry + envelope unwrap) and
+ * `listAll` (offset-pagination iterator) helpers that wrap any operation.
+ *
+ * Each instance owns its own HTTP client: constructing a second AIRV2 with a
+ * different URL or key does not affect earlier instances (unlike the v1 AIR
+ * class, which configures a process-wide singleton).
+ */
+export declare class AIRV2 {
+    private readonly retryOptions;
+    /**
+     * Raw generated v2 operations from swagger-v2.json (one per operationId),
+     * bound to this instance's client.
+     */
+    readonly operations: SdkOperations;
+    private readonly client;
+    constructor(url: string, apiKey: string, retryOptions?: RetryOptions);
+    /**
+     * Runs a generated operation with status-based retry and unwraps the v2
+     * envelope, throwing AirV2Error on failure. Mutations retry only on
+     * 408/429 by default; pass { idempotent: true } for side-effect-free
+     * operations to also retry transient 5xx statuses.
+     *
+     * Example:
+     *   const page = await air.request(() =>
+     *     air.operations.caseV2ApiControllerFilterCases({ query: { pageNumber: 1 } }),
+     *     { idempotent: true });
+     */
+    request<T>(send: () => Promise<V2AxiosResponse>, options?: RequestOptions): Promise<T>;
+    /**
+     * Iterates every entity of an offset-paginated list operation, walking
+     * pageNumber until the envelope's result.nextPage is null. List reads are
+     * idempotent, so transient 5xx statuses are retried.
+     */
+    listAll<T>(fetchPage: (pageNumber: number) => Promise<V2AxiosResponse>): AsyncGenerator<T, void, undefined>;
+    private retryOptionsFor;
+}
+export {};

package/dist/v2/AIR.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIRV2 = void 0;
+const bindings_v2_1 = require("../generated/bindings-v2");
+const page_iterator_1 = require("../utils/page-iterator");
+const retry_1 = require("../utils/retry");
+const typed_errors_1 = require("../utils/typed-errors");
+const utils_1 = require("../utils/utils");
+/**
+ * v2-aware AIR client (Plan PR 18). Exposes the full generated operation
+ * surface as `operations`, plus `request` (retry + envelope unwrap) and
+ * `listAll` (offset-pagination iterator) helpers that wrap any operation.
+ *
+ * Each instance owns its own HTTP client: constructing a second AIRV2 with a
+ * different URL or key does not affect earlier instances (unlike the v1 AIR
+ * class, which configures a process-wide singleton).
+ */
+class AIRV2 {
+    constructor(url, apiKey, retryOptions = {}) {
+        this.retryOptions = retryOptions;
+        this.client = (0, bindings_v2_1.createClientV2)((0, bindings_v2_1.createConfigV2)());
+        this.client.setConfig({
+            baseURL: url,
+            headers: { Authorization: `Bearer ${apiKey}` },
+            validateStatus: () => true,
+            querySerializer: utils_1.serializeQueryDeep,
+        });
+        this.operations = bindOperations(this.client);
+    }
+    /**
+     * Runs a generated operation with status-based retry and unwraps the v2
+     * envelope, throwing AirV2Error on failure. Mutations retry only on
+     * 408/429 by default; pass { idempotent: true } for side-effect-free
+     * operations to also retry transient 5xx statuses.
+     *
+     * Example:
+     *   const page = await air.request(() =>
+     *     air.operations.caseV2ApiControllerFilterCases({ query: { pageNumber: 1 } }),
+     *     { idempotent: true });
+     */
+    async request(send, options = {}) {
+        const response = await (0, retry_1.withRetry)(send, this.retryOptionsFor(options.idempotent === true));
+        return (0, typed_errors_1.unwrapV2Envelope)(response.data, response.status, (0, retry_1.readRetryAfterHeader)(response.headers));
+    }
+    /**
+     * Iterates every entity of an offset-paginated list operation, walking
+     * pageNumber until the envelope's result.nextPage is null. List reads are
+     * idempotent, so transient 5xx statuses are retried.
+     */
+    listAll(fetchPage) {
+        const retryOptions = this.retryOptionsFor(true);
+        return (0, page_iterator_1.iterateOffsetPages)(async (pageNumber) => {
+            const response = await (0, retry_1.withRetry)(() => fetchPage(pageNumber), retryOptions);
+            return (0, typed_errors_1.unwrapV2Envelope)(response.data, response.status, (0, retry_1.readRetryAfterHeader)(response.headers));
+        });
+    }
+    retryOptionsFor(idempotent) {
+        return {
+            ...this.retryOptions,
+            retryableStatuses: this.retryOptions.retryableStatuses ??
+                (idempotent ? retry_1.DEFAULT_RETRYABLE_STATUSES : retry_1.MUTATION_RETRYABLE_STATUSES),
+        };
+    }
+}
+exports.AIRV2 = AIRV2;
+function bindOperations(client) {
+    const bound = {};
+    for (const [name, operation] of Object.entries(bindings_v2_1.sdkV2)) {
+        if (typeof operation !== 'function') {
+            bound[name] = operation;
+            continue;
+        }
+        // The instance client is spread last so a stray `client` in the caller's
+        // options cannot replace it — per-instance isolation must hold even when
+        // callers pass hey-api's per-call `client` option.
+        bound[name] = (options = {}) => operation({ ...options, client });
+    }
+    return bound;
+}
+//# sourceMappingURL=AIR.js.map

package/dist/v2/AIR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIR.js","sourceRoot":"","sources":["../../src/v2/AIR.ts"],"names":[],"mappings":";;;AAAA,0DAAiF;AACjF,0DAA4E;AAC5E,0CAMwB;AACxB,wDAAyD;AACzD,0CAAoD;AAqBpD;;;;;;;;GAQG;AACH,MAAa,KAAK;IAShB,YACE,GAAW,EACX,MAAc,EACG,eAA6B,EAAE;QAA/B,iBAAY,GAAZ,YAAY,CAAmB;QAEhD,IAAI,CAAC,MAAM,GAAG,IAAA,4BAAc,EAAC,IAAA,4BAAc,GAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;YAC9C,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI;YAC1B,eAAe,EAAE,0BAAkB;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CACX,IAAoC,EACpC,UAA0B,EAAE;QAE5B,MAAM,QAAQ,GAAG,MAAM,IAAA,iBAAS,EAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC;QAC1F,OAAO,IAAA,+BAAgB,EACrB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,MAAM,EACf,IAAA,4BAAoB,EAAC,QAAQ,CAAC,OAAO,CAAC,CACvC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,OAAO,CACL,SAA2D;QAE3D,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAA,kCAAkB,EAAI,KAAK,EAAE,UAAU,EAAE,EAAE;YAChD,MAAM,QAAQ,GAAG,MAAM,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;YAC5E,OAAO,IAAA,+BAAgB,EACrB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,MAAM,EACf,IAAA,4BAAoB,EAAC,QAAQ,CAAC,OAAO,CAAC,CACvC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,UAAmB;QACzC,OAAO;YACL,GAAG,IAAI,CAAC,YAAY;YACpB,iBAAiB,EACf,IAAI,CAAC,YAAY,CAAC,iBAAiB;gBACnC,CAAC,UAAU,CAAC,CAAC,CAAC,kCAA0B,CAAC,CAAC,CAAC,mCAA2B,CAAC;SAC1E,CAAC;IACJ,CAAC;CACF;AA1ED,sBA0EC;AAED,SAAS,cAAc,CAAC,MAAgB;IACtC,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAK,CAAC,EAAE,CAAC;QACtD,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;YACxB,SAAS;QACX,CAAC;QACD,yEAAyE;QACzE,yEAAyE;QACzE,mDAAmD;QACnD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAmC,EAAE,EAAE,EAAE,CACrD,SAAwD,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC"}

package/dist/v2/index.d.ts

@@ -0,0 +1 @@
+export * from './AIR';

package/dist/v2/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AIR"), exports);
+//# sourceMappingURL=index.js.map

package/dist/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@binalyze/air-sdk",
-  "version": "5.22.4",
+  "version": "5.24.3",
   "private": false,
   "description": "Binalyze AIR - Typescript Axios SDK",
   "license": "MIT",