listbee 0.3.0

package/dist/esm/errors.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Typed exception hierarchy for the ListBee SDK (RFC 9457).
+ */
+/** Base class for all ListBee SDK errors. */
+export declare class ListBeeError extends Error {
+    constructor(message: string);
+}
+/** Raised when a network error prevents the request from completing. */
+export declare class APIConnectionError extends ListBeeError {
+    constructor(message: string);
+}
+/** Raised when a request times out. */
+export declare class APITimeoutError extends ListBeeError {
+    constructor(message: string);
+}
+/** Raised when the API returns an error response (4xx/5xx). */
+export declare class APIStatusError extends ListBeeError {
+    /** URI identifying the error type. */
+    readonly type: string;
+    /** Short, stable label for the error category. */
+    readonly title: string;
+    /** HTTP status code. */
+    readonly status: number;
+    /** Specific explanation of what went wrong. */
+    readonly detail: string;
+    /** Machine-readable error code. */
+    readonly code: string;
+    /** Request field that caused the error, if applicable. */
+    readonly param: string | null;
+    constructor(opts: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        code: string;
+        param?: string | null;
+    });
+}
+/** Raised on 401 responses — invalid or missing API key. */
+export declare class AuthenticationError extends APIStatusError {
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0]);
+}
+/** Raised on 404 responses — resource not found. */
+export declare class NotFoundError extends APIStatusError {
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0]);
+}
+/** Raised on 409 responses — resource conflict. */
+export declare class ConflictError extends APIStatusError {
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0]);
+}
+/** Raised on 422 responses — request validation failed. */
+export declare class ValidationError extends APIStatusError {
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0]);
+}
+/** Raised on 429 responses — rate limit exceeded. */
+export declare class RateLimitError extends APIStatusError {
+    /** Max requests per window. */
+    readonly limit: number | null;
+    /** Requests remaining in current window. */
+    readonly remaining: number | null;
+    /** When the current window resets (Unix timestamp). */
+    readonly reset: number | null;
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0] & {
+        limit?: number | null;
+        remaining?: number | null;
+        reset?: number | null;
+    });
+}
+/** Raised on 500+ responses — server-side error. */
+export declare class InternalServerError extends APIStatusError {
+    constructor(opts: ConstructorParameters<typeof APIStatusError>[0]);
+}
+/** Raised when webhook signature verification fails. */
+export declare class WebhookVerificationError extends ListBeeError {
+    constructor(message: string);
+}
+type ErrorBody = {
+    type?: unknown;
+    title?: unknown;
+    status?: unknown;
+    detail?: unknown;
+    code?: unknown;
+    param?: unknown;
+};
+/**
+ * Parse an RFC 9457 error body and throw the appropriate typed exception.
+ */
+export declare function raiseForStatus(statusCode: number, body: ErrorBody, headers: Record<string, string>): never;
+export {};

package/dist/esm/errors.js

@@ -0,0 +1,124 @@
+/**
+ * Typed exception hierarchy for the ListBee SDK (RFC 9457).
+ */
+/** Base class for all ListBee SDK errors. */
+export class ListBeeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ListBeeError';
+    }
+}
+/** Raised when a network error prevents the request from completing. */
+export class APIConnectionError extends ListBeeError {
+    constructor(message) {
+        super(message);
+        this.name = 'APIConnectionError';
+    }
+}
+/** Raised when a request times out. */
+export class APITimeoutError extends ListBeeError {
+    constructor(message) {
+        super(message);
+        this.name = 'APITimeoutError';
+    }
+}
+/** Raised when the API returns an error response (4xx/5xx). */
+export class APIStatusError extends ListBeeError {
+    constructor(opts) {
+        super(opts.detail);
+        this.name = 'APIStatusError';
+        this.type = opts.type;
+        this.title = opts.title;
+        this.status = opts.status;
+        this.detail = opts.detail;
+        this.code = opts.code;
+        this.param = opts.param ?? null;
+    }
+}
+/** Raised on 401 responses — invalid or missing API key. */
+export class AuthenticationError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'AuthenticationError';
+    }
+}
+/** Raised on 404 responses — resource not found. */
+export class NotFoundError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'NotFoundError';
+    }
+}
+/** Raised on 409 responses — resource conflict. */
+export class ConflictError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'ConflictError';
+    }
+}
+/** Raised on 422 responses — request validation failed. */
+export class ValidationError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'ValidationError';
+    }
+}
+/** Raised on 429 responses — rate limit exceeded. */
+export class RateLimitError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'RateLimitError';
+        this.limit = opts.limit ?? null;
+        this.remaining = opts.remaining ?? null;
+        this.reset = opts.reset ?? null;
+    }
+}
+/** Raised on 500+ responses — server-side error. */
+export class InternalServerError extends APIStatusError {
+    constructor(opts) {
+        super(opts);
+        this.name = 'InternalServerError';
+    }
+}
+/** Raised when webhook signature verification fails. */
+export class WebhookVerificationError extends ListBeeError {
+    constructor(message) {
+        super(message);
+        this.name = 'WebhookVerificationError';
+    }
+}
+/**
+ * Parse an RFC 9457 error body and throw the appropriate typed exception.
+ */
+export function raiseForStatus(statusCode, body, headers) {
+    const type = typeof body.type === 'string' ? body.type : '';
+    const title = typeof body.title === 'string' ? body.title : '';
+    const status = typeof body.status === 'number' ? body.status : statusCode;
+    const detail = typeof body.detail === 'string' ? body.detail : '';
+    const code = typeof body.code === 'string' ? body.code : '';
+    const param = typeof body.param === 'string' ? body.param : null;
+    const base = { type, title, status, detail, code, param };
+    if (statusCode === 401)
+        throw new AuthenticationError(base);
+    if (statusCode === 404)
+        throw new NotFoundError(base);
+    if (statusCode === 409)
+        throw new ConflictError(base);
+    if (statusCode === 422)
+        throw new ValidationError(base);
+    if (statusCode === 429) {
+        const limitStr = headers['x-ratelimit-limit'];
+        const remainingStr = headers['x-ratelimit-remaining'];
+        const resetStr = headers['x-ratelimit-reset'];
+        throw new RateLimitError({
+            ...base,
+            limit: limitStr != null ? parseInt(limitStr, 10) : null,
+            remaining: remainingStr != null ? parseInt(remainingStr, 10) : null,
+            reset: resetStr != null ? parseFloat(resetStr) : null,
+        });
+    }
+    if (statusCode >= 500)
+        throw new InternalServerError(base);
+    throw new APIStatusError(base);
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,uCAAuC;AACvC,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,OAAO,cAAe,SAAQ,YAAY;IAc9C,YAAY,IAOX;QACC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAClC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,oDAAoD;AACpD,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,OAAO,cAAe,SAAQ,cAAc;IAQhD,YACE,IAIC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAClC,CAAC;CACF;AAED,oDAAoD;AACpD,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAWD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAe,EAAE,OAA+B;IACjG,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAEjE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAE1D,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,IAAI,cAAc,CAAC;YACvB,GAAG,IAAI;YACP,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YACvD,SAAS,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YACnE,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;SACtD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,IAAI,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE3D,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ListBee TypeScript SDK — public exports.
+ */
+export { ListBee } from './client';
+export type { ClientOptions } from './client';
+export { CursorPage } from './base-client';
+export type { RequestOptions } from './base-client';
+export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, ConflictError, InternalServerError, ListBeeError, NotFoundError, RateLimitError, ValidationError, WebhookVerificationError, } from './errors';
+export { AccountResource } from './resources/account';
+export { ListingsResource } from './resources/listings';
+export { ApiKeysResource } from './resources/api-keys';
+export { OrdersResource } from './resources/orders';
+export { SignupResource } from './resources/signup';
+export { StripeResource } from './resources/stripe';
+export { StoresResource } from './resources/stores';
+export { WebhooksResource } from './resources/webhooks';
+export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
+export type { AccountReadiness, ListingReadiness, ReadinessAction, ListResponse, } from './types/shared';
+export type { AccountResponse, UpdateAccountParams, AccountStats } from './types/account';
+export type { BlurMode, CreateListingParams, FaqItem, ListingResponse, ListingStatus, Review, UpdateListingParams, } from './types/listing';
+export type { ApiKeyResponse } from './types/api-key';
+export type { OrderResponse, ListOrdersParams } from './types/order';
+export type { SignupResponse, VerifyResponse } from './types/signup';
+export type { StripeConnectSessionResponse } from './types/stripe';
+export type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse, } from './types/webhook';
+export type { StoreResponse, StoreListResponse, DomainResponse, DomainStatus, CreateStoreParams, UpdateStoreParams } from './types/store';

package/dist/esm/index.js

@@ -0,0 +1,20 @@
+/**
+ * ListBee TypeScript SDK — public exports.
+ */
+// Client
+export { ListBee } from './client';
+export { CursorPage } from './base-client';
+// Errors
+export { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, ConflictError, InternalServerError, ListBeeError, NotFoundError, RateLimitError, ValidationError, WebhookVerificationError, } from './errors';
+// Resources
+export { AccountResource } from './resources/account';
+export { ListingsResource } from './resources/listings';
+export { ApiKeysResource } from './resources/api-keys';
+export { OrdersResource } from './resources/orders';
+export { SignupResource } from './resources/signup';
+export { StripeResource } from './resources/stripe';
+export { StoresResource } from './resources/stores';
+export { WebhooksResource } from './resources/webhooks';
+// Enums (runtime values)
+export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,SAAS;AACT,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,yBAAyB;AACzB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/resources/account.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Account resource — GET and PUT /v1/account.
+ */
+import type { BaseClient } from '../base-client';
+import type { AccountResponse, UpdateAccountParams } from '../types/account';
+/** Resource for the /v1/account endpoint. */
+export declare class AccountResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    /**
+     * Retrieve the current account.
+     *
+     * @returns The AccountResponse for the authenticated account.
+     */
+    get(): Promise<AccountResponse>;
+    /**
+     * Update account settings.
+     *
+     * @param params - Fields to update.
+     * @param params.ga_measurement_id - Google Analytics 4 Measurement ID (e.g. "G-XXXXXXXXXX").
+     *   Pass `null` to clear the existing value.
+     * @returns The updated AccountResponse.
+     */
+    update(params?: UpdateAccountParams): Promise<AccountResponse>;
+}

package/dist/esm/resources/account.js

@@ -0,0 +1,35 @@
+/**
+ * Account resource — GET and PUT /v1/account.
+ */
+/** Resource for the /v1/account endpoint. */
+export class AccountResource {
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * Retrieve the current account.
+     *
+     * @returns The AccountResponse for the authenticated account.
+     */
+    async get() {
+        const response = await this._client.get('/v1/account');
+        return (await response.json());
+    }
+    /**
+     * Update account settings.
+     *
+     * @param params - Fields to update.
+     * @param params.ga_measurement_id - Google Analytics 4 Measurement ID (e.g. "G-XXXXXXXXXX").
+     *   Pass `null` to clear the existing value.
+     * @returns The updated AccountResponse.
+     */
+    async update(params = {}) {
+        const body = {};
+        if ('ga_measurement_id' in params) {
+            body['ga_measurement_id'] = params.ga_measurement_id;
+        }
+        const response = await this._client.put('/v1/account', body);
+        return (await response.json());
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/esm/resources/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,6CAA6C;AAC7C,MAAM,OAAO,eAAe;IAC1B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,SAA8B,EAAE;QAC3C,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACvD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;CACF"}

package/dist/esm/resources/api-keys.d.ts

@@ -0,0 +1,14 @@
+/**
+ * API Keys resource — GET, POST, DELETE /v1/api-keys.
+ */
+import type { BaseClient } from '../base-client';
+import type { ApiKeyResponse } from '../types/api-key';
+export declare class ApiKeysResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    list(): Promise<ApiKeyResponse[]>;
+    create(params: {
+        name: string;
+    }): Promise<ApiKeyResponse>;
+    delete(keyId: string): Promise<void>;
+}

package/dist/esm/resources/api-keys.js

@@ -0,0 +1,21 @@
+/**
+ * API Keys resource — GET, POST, DELETE /v1/api-keys.
+ */
+export class ApiKeysResource {
+    constructor(_client) {
+        this._client = _client;
+    }
+    async list() {
+        const response = await this._client.get('/v1/api-keys');
+        const body = (await response.json());
+        return (body.data ?? []);
+    }
+    async create(params) {
+        const response = await this._client.post('/v1/api-keys', { name: params.name });
+        return (await response.json());
+    }
+    async delete(keyId) {
+        await this._client.delete(`/v1/api-keys/${keyId}`);
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/esm/resources/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../../../src/resources/api-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,eAAe;IAC1B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAqB,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/esm/resources/index.d.ts

@@ -0,0 +1,7 @@
+export { AccountResource } from './account';
+export { ListingsResource } from './listings';
+export { ApiKeysResource } from './api-keys';
+export { OrdersResource } from './orders';
+export { SignupResource } from './signup';
+export { StripeResource } from './stripe';
+export { WebhooksResource } from './webhooks';

package/dist/esm/resources/index.js

@@ -0,0 +1,8 @@
+export { AccountResource } from './account';
+export { ListingsResource } from './listings';
+export { ApiKeysResource } from './api-keys';
+export { OrdersResource } from './orders';
+export { SignupResource } from './signup';
+export { StripeResource } from './stripe';
+export { WebhooksResource } from './webhooks';
+//# sourceMappingURL=index.js.map

package/dist/esm/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/resources/listings.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Listings resource — CRUD + pause/resume for /v1/listings.
+ */
+import type { BaseClient, CursorPage } from '../base-client';
+import type { CreateListingParams, ListingResponse, UpdateListingParams } from '../types/listing';
+/** Resource for the /v1/listings endpoint. */
+export declare class ListingsResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    /**
+     * Create a new listing.
+     *
+     * Builds the request body from provided params. `cover_blur` is only
+     * included when it differs from the API default of "auto".
+     * Currency is inherited from the account.
+     *
+     * @param params - Listing creation parameters.
+     * @returns The created ListingResponse.
+     */
+    create(params: CreateListingParams): Promise<ListingResponse>;
+    /**
+     * Retrieve a listing by its URL slug.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The ListingResponse for that slug.
+     */
+    get(slug: string): Promise<ListingResponse>;
+    /**
+     * Return a paginated list of listings.
+     *
+     * @param params - Pagination parameters.
+     * @param params.limit - Maximum items per page (default 20).
+     * @param params.cursor - Pagination cursor from a previous response.
+     * @returns A CursorPage of ListingResponse objects.
+     */
+    list(params?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CursorPage<ListingResponse>>;
+    /**
+     * Update an existing listing.
+     *
+     * Only the supplied fields are updated; all others remain unchanged.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @param params - Fields to update.
+     * @returns The updated ListingResponse.
+     */
+    update(slug: string, params: UpdateListingParams): Promise<ListingResponse>;
+    /**
+     * Pause a listing, preventing new purchases.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The paused ListingResponse.
+     */
+    pause(slug: string): Promise<ListingResponse>;
+    /**
+     * Resume a paused listing, allowing new purchases.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The resumed ListingResponse.
+     */
+    resume(slug: string): Promise<ListingResponse>;
+    /**
+     * Delete a listing.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     */
+    delete(slug: string): Promise<void>;
+}

package/dist/esm/resources/listings.js

@@ -0,0 +1,156 @@
+/**
+ * Listings resource — CRUD + pause/resume for /v1/listings.
+ */
+import { LISTING_CREATE_TIMEOUT_MS } from '../constants';
+/** Resource for the /v1/listings endpoint. */
+export class ListingsResource {
+    constructor(_client) {
+        this._client = _client;
+    }
+    /**
+     * Create a new listing.
+     *
+     * Builds the request body from provided params. `cover_blur` is only
+     * included when it differs from the API default of "auto".
+     * Currency is inherited from the account.
+     *
+     * @param params - Listing creation parameters.
+     * @returns The created ListingResponse.
+     */
+    async create(params) {
+        const { name, price, content, timeoutMs, cover_blur, ...rest } = params;
+        const body = { name, price, content };
+        const optionalFields = [
+            'description',
+            'tagline',
+            'highlights',
+            'cta',
+            'cover_url',
+            'metadata',
+            'compare_at_price',
+            'badges',
+            'rating',
+            'rating_count',
+            'reviews',
+            'faqs',
+            'store_id',
+        ];
+        for (const field of optionalFields) {
+            if (rest[field] !== undefined) {
+                body[field] = rest[field];
+            }
+        }
+        // cover_blur is only sent when different from the default "auto"
+        if (cover_blur !== undefined && cover_blur !== 'auto') {
+            body['cover_blur'] = cover_blur;
+        }
+        // UTM fields — include when explicitly provided (even null)
+        if ('utm_source' in params)
+            body['utm_source'] = params.utm_source;
+        if ('utm_medium' in params)
+            body['utm_medium'] = params.utm_medium;
+        if ('utm_campaign' in params)
+            body['utm_campaign'] = params.utm_campaign;
+        const effectiveTimeout = timeoutMs ?? LISTING_CREATE_TIMEOUT_MS;
+        const response = await this._client.post('/v1/listings', body, { timeoutMs: effectiveTimeout });
+        return (await response.json());
+    }
+    /**
+     * Retrieve a listing by its URL slug.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The ListingResponse for that slug.
+     */
+    async get(slug) {
+        const response = await this._client.get(`/v1/listings/${slug}`);
+        return (await response.json());
+    }
+    /**
+     * Return a paginated list of listings.
+     *
+     * @param params - Pagination parameters.
+     * @param params.limit - Maximum items per page (default 20).
+     * @param params.cursor - Pagination cursor from a previous response.
+     * @returns A CursorPage of ListingResponse objects.
+     */
+    async list(params = {}) {
+        const queryParams = {
+            limit: params.limit ?? 20,
+        };
+        if (params.cursor !== undefined)
+            queryParams['cursor'] = params.cursor;
+        return this._client.getPage('/v1/listings', queryParams, (item) => item);
+    }
+    /**
+     * Update an existing listing.
+     *
+     * Only the supplied fields are updated; all others remain unchanged.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @param params - Fields to update.
+     * @returns The updated ListingResponse.
+     */
+    async update(slug, params) {
+        const body = {};
+        const fields = [
+            'name',
+            'price',
+            'description',
+            'tagline',
+            'highlights',
+            'cta',
+            'cover_url',
+            'metadata',
+            'compare_at_price',
+            'badges',
+            'cover_blur',
+            'rating',
+            'rating_count',
+            'reviews',
+            'faqs',
+        ];
+        for (const field of fields) {
+            if (params[field] !== undefined) {
+                body[field] = params[field];
+            }
+        }
+        // UTM fields — include when explicitly provided (even null)
+        if ('utm_source' in params)
+            body['utm_source'] = params.utm_source;
+        if ('utm_medium' in params)
+            body['utm_medium'] = params.utm_medium;
+        if ('utm_campaign' in params)
+            body['utm_campaign'] = params.utm_campaign;
+        const response = await this._client.put(`/v1/listings/${slug}`, body);
+        return (await response.json());
+    }
+    /**
+     * Pause a listing, preventing new purchases.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The paused ListingResponse.
+     */
+    async pause(slug) {
+        const response = await this._client.post(`/v1/listings/${slug}/pause`);
+        return (await response.json());
+    }
+    /**
+     * Resume a paused listing, allowing new purchases.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     * @returns The resumed ListingResponse.
+     */
+    async resume(slug) {
+        const response = await this._client.post(`/v1/listings/${slug}/resume`);
+        return (await response.json());
+    }
+    /**
+     * Delete a listing.
+     *
+     * @param slug - The listing's URL slug (e.g. "seo-playbook").
+     */
+    async delete(slug) {
+        await this._client.delete(`/v1/listings/${slug}`);
+    }
+}
+//# sourceMappingURL=listings.js.map

package/dist/esm/resources/listings.js.map

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

package/dist/esm/resources/orders.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Orders resource — GET /v1/orders/{id}, GET /v1/orders.
+ */
+import type { BaseClient, CursorPage } from '../base-client';
+import type { OrderResponse, ListOrdersParams } from '../types/order';
+export declare class OrdersResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    get(orderId: string): Promise<OrderResponse>;
+    list(params?: ListOrdersParams): Promise<CursorPage<OrderResponse>>;
+}