listbee 0.3.0

package/dist/esm/types/shared.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Shared types used across multiple resources.
+ */
+/** A single readiness action describing how to resolve an issue. */
+export interface ReadinessAction {
+    /** Machine-readable action code. */
+    code: string;
+    /** Whether this action is resolved via the API or manually by the human. */
+    kind: 'api' | 'human';
+    /** Human-readable description of the action. */
+    message: string;
+    /** How to resolve this action. */
+    resolve: {
+        /** HTTP method for API actions. */
+        method: string;
+        /** API endpoint path for `kind: "api"` actions. */
+        endpoint: string | null;
+        /** External URL for `kind: "human"` actions. */
+        url: string | null;
+        /** Request parameters to include. */
+        params: Record<string, unknown> | null;
+    };
+}
+/** Account operational readiness. */
+export interface AccountReadiness {
+    /** Whether the account can accept payments. */
+    operational: boolean;
+    /** List of actions required to become operational. */
+    actions: ReadinessAction[];
+    /** Code of the highest-priority action, or null if operational. */
+    next: string | null;
+}
+/** Listing monetization readiness. */
+export interface ListingReadiness {
+    /** Whether buyers can complete a purchase on this listing. */
+    sellable: boolean;
+    /** List of actions required to become sellable. */
+    actions: ReadinessAction[];
+    /** Code of the highest-priority action, or null if sellable. */
+    next: string | null;
+}
+/** Paginated list response wrapper. */
+export interface ListResponse<T> {
+    object: 'list';
+    data: T[];
+    has_more: boolean;
+    cursor: string | null;
+}
+/** Content type — auto-detected from the content value at creation. */
+export declare const ContentType: {
+    readonly FILE: "file";
+    readonly URL: "url";
+    readonly TEXT: "text";
+};
+export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+/** Order status. */
+export declare const OrderStatus: {
+    readonly COMPLETED: "completed";
+};
+export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
+/** Webhook event type. */
+export declare const WebhookEventType: {
+    readonly ORDER_COMPLETED: "order.completed";
+    readonly ORDER_REFUNDED: "order.refunded";
+    readonly ORDER_DISPUTED: "order.disputed";
+    readonly ORDER_DISPUTE_CLOSED: "order.dispute_closed";
+    readonly LISTING_CREATED: "listing.created";
+    readonly LISTING_UPDATED: "listing.updated";
+    readonly LISTING_PAUSED: "listing.paused";
+    readonly LISTING_RESUMED: "listing.resumed";
+    readonly LISTING_DELETED: "listing.deleted";
+};
+export type WebhookEventType = (typeof WebhookEventType)[keyof typeof WebhookEventType];
+/** Readiness action kind. */
+export declare const ActionKind: {
+    readonly API: "api";
+    readonly HUMAN: "human";
+};
+export type ActionKind = (typeof ActionKind)[keyof typeof ActionKind];
+/** Readiness action code. */
+export declare const ActionCode: {
+    readonly SET_STRIPE_KEY: "set_stripe_key";
+    readonly CONNECT_STRIPE: "connect_stripe";
+    readonly ENABLE_CHARGES: "enable_charges";
+    readonly UPDATE_BILLING: "update_billing";
+};
+export type ActionCode = (typeof ActionCode)[keyof typeof ActionCode];

package/dist/esm/types/shared.js

@@ -0,0 +1,38 @@
+/**
+ * Shared types used across multiple resources.
+ */
+/** Content type — auto-detected from the content value at creation. */
+export const ContentType = {
+    FILE: 'file',
+    URL: 'url',
+    TEXT: 'text',
+};
+/** Order status. */
+export const OrderStatus = {
+    COMPLETED: 'completed',
+};
+/** Webhook event type. */
+export const WebhookEventType = {
+    ORDER_COMPLETED: 'order.completed',
+    ORDER_REFUNDED: 'order.refunded',
+    ORDER_DISPUTED: 'order.disputed',
+    ORDER_DISPUTE_CLOSED: 'order.dispute_closed',
+    LISTING_CREATED: 'listing.created',
+    LISTING_UPDATED: 'listing.updated',
+    LISTING_PAUSED: 'listing.paused',
+    LISTING_RESUMED: 'listing.resumed',
+    LISTING_DELETED: 'listing.deleted',
+};
+/** Readiness action kind. */
+export const ActionKind = {
+    API: 'api',
+    HUMAN: 'human',
+};
+/** Readiness action code. */
+export const ActionCode = {
+    SET_STRIPE_KEY: 'set_stripe_key',
+    CONNECT_STRIPE: 'connect_stripe',
+    ENABLE_CHARGES: 'enable_charges',
+    UPDATE_BILLING: 'update_billing',
+};
+//# sourceMappingURL=shared.js.map

package/dist/esm/types/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmDH,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,oBAAoB;AACpB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW;CACd,CAAC;AAGX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,oBAAoB,EAAE,sBAAsB;IAC5C,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAGX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACN,CAAC;AAGX,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;CACxB,CAAC"}

package/dist/esm/types/signup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Signup response types.
+ */
+import type { AccountResponse } from './account';
+/** Response from the signup create endpoint. */
+export interface SignupResponse {
+    /** Object type discriminator. Always "signup_session". */
+    object: 'signup_session';
+    /** Email the OTP was sent to. */
+    email: string;
+    /** Always "otp_sent". */
+    status: 'otp_sent';
+    /** Human-readable message. */
+    message: string;
+}
+/** Response from the signup verify endpoint. */
+export interface VerifyResponse {
+    /** Object type discriminator. Always "signup_result". */
+    object: 'signup_result';
+    /** The newly created account. */
+    account: AccountResponse;
+    /** Raw API key value — store this, it's only shown once. */
+    api_key: string;
+}

package/dist/esm/types/signup.js

@@ -0,0 +1,5 @@
+/**
+ * Signup response types.
+ */
+export {};
+//# sourceMappingURL=signup.js.map

package/dist/esm/types/signup.js.map

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

package/dist/esm/types/store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Store and domain response types.
+ */
+/** Domain verification status. */
+export type DomainStatus = 'pending' | 'verified' | 'stale';
+/** Store object returned by the ListBee API. */
+export interface StoreResponse {
+    /** Object type discriminator. Always "store". */
+    object: 'store';
+    /** Unique store identifier. */
+    id: string;
+    /** URL-safe handle used in platform URLs. */
+    handle: string;
+    /** Store display name. Falls back to @handle if not set. */
+    name: string | null;
+    /** Resolved display name: name if set, otherwise @handle. */
+    display_name: string;
+    /** Short store bio. */
+    bio: string | null;
+    /** Social media URLs. */
+    social_links: string[];
+    /** True when the store has a payment provider configured. */
+    payment_connected: boolean;
+    /** Payment provider name or null if not configured. */
+    payment_provider: string | null;
+    /** Default currency code (ISO 4217, lowercase). Null until payment configured. */
+    currency: string | null;
+    /** Custom domain configured on this store. Null if not set. */
+    domain: string | null;
+    /** Domain verification status. Null if no domain configured. */
+    domain_status: DomainStatus | null;
+    /** Number of listings in this store. */
+    listing_count: number;
+    /** ISO 8601 timestamp of when the store was created. */
+    created_at: string;
+}
+/** Non-paginated list of stores. */
+export interface StoreListResponse {
+    object: 'list';
+    data: StoreResponse[];
+}
+/** Custom domain object returned by the ListBee API. */
+export interface DomainResponse {
+    /** Object type discriminator. Always "domain". */
+    object: 'domain';
+    /** The custom domain. */
+    domain: string;
+    /** Verification status: pending, verified, or stale. */
+    status: DomainStatus;
+    /** The CNAME target the domain must point to. */
+    cname_target: string;
+    /** Timestamp when domain was verified. Null if not yet verified. */
+    verified_at: string | null;
+}
+/** Parameters for creating a store. */
+export interface CreateStoreParams {
+    /** URL-safe handle, unique globally. */
+    handle: string;
+    /** Optional display name. */
+    name?: string;
+}
+/** Parameters for updating a store. */
+export interface UpdateStoreParams {
+    /** Store display name. */
+    name?: string;
+    /** Short store bio. */
+    bio?: string;
+    /** Social media URLs (HTTPS only, max 5). */
+    social_links?: string[];
+}

package/dist/esm/types/store.js

@@ -0,0 +1,5 @@
+/**
+ * Store and domain response types.
+ */
+export {};
+//# sourceMappingURL=store.js.map

package/dist/esm/types/store.js.map

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

package/dist/esm/types/stripe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stripe resource response types.
+ */
+/** Response from the Stripe Connect session endpoint. */
+export interface StripeConnectSessionResponse {
+    /** Object type discriminator. Always "stripe_connect_session". */
+    object: 'stripe_connect_session';
+    /** Stripe Connect onboarding URL — redirect the user here. */
+    url: string;
+    /** ISO 8601 timestamp when this session expires. */
+    expires_at: string;
+}

package/dist/esm/types/stripe.js

@@ -0,0 +1,5 @@
+/**
+ * Stripe resource response types.
+ */
+export {};
+//# sourceMappingURL=stripe.js.map

package/dist/esm/types/stripe.js.map

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

package/dist/esm/types/webhook.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Webhook response types.
+ */
+import type { WebhookEventType } from './shared';
+/** Full webhook object returned by the ListBee API. */
+export interface WebhookResponse {
+    /** Object type discriminator. Always "webhook". */
+    object: 'webhook';
+    /** Unique webhook identifier. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** HTTPS endpoint URL. */
+    url: string;
+    /** HMAC signing secret for verifying payloads. */
+    secret: string;
+    /** Event types to subscribe to. Empty array = all events. */
+    events: WebhookEventType[];
+    /** Whether this webhook is currently active. */
+    enabled: boolean;
+    /** ISO 8601 timestamp of when the webhook was created. */
+    created_at: string;
+}
+/** Parameters for creating a webhook. */
+export interface CreateWebhookParams {
+    /** Display name. */
+    name: string;
+    /** HTTPS endpoint URL. */
+    url: string;
+    /** Event types to subscribe to. Omit or empty = all events. */
+    events?: WebhookEventType[];
+}
+/** Parameters for updating a webhook. All fields optional. */
+export interface UpdateWebhookParams {
+    /** Display name. */
+    name?: string;
+    /** HTTPS endpoint URL. */
+    url?: string;
+    /** Event types to subscribe to. */
+    events?: WebhookEventType[];
+    /** Whether this webhook is active. */
+    enabled?: boolean;
+}
+/** A single webhook delivery event. */
+export interface WebhookEventResponse {
+    /** Object type discriminator. Always "webhook_event". */
+    object: 'webhook_event';
+    /** Unique event identifier. */
+    id: string;
+    /** The event type that triggered this delivery. */
+    event_type: WebhookEventType;
+    /** Delivery status. */
+    status: 'pending' | 'delivered' | 'failed';
+    /** Number of delivery attempts so far. */
+    attempts: number;
+    /** Maximum delivery attempts before marking as failed. */
+    max_retries: number;
+    /** HTTP status code from the last delivery attempt. */
+    response_status: number | null;
+    /** Error message from the last failed delivery attempt. */
+    last_error: string | null;
+    /** ISO 8601 timestamp of when the event was created. */
+    created_at: string;
+    /** ISO 8601 timestamp of successful delivery. */
+    delivered_at: string | null;
+}
+/** Parameters for listing webhook events. */
+export interface ListWebhookEventsParams {
+    /** Filter by delivery status. */
+    status?: 'pending' | 'delivered' | 'failed';
+    /** Maximum items per page (default 20). */
+    limit?: number;
+    /** Pagination cursor from a previous response. */
+    cursor?: string;
+}
+/** Response from the webhook test endpoint. */
+export interface WebhookTestResponse {
+    /** Object type discriminator. Always "webhook_test". */
+    object: 'webhook_test';
+    /** Whether the test delivery succeeded (endpoint returned 2xx). */
+    success: boolean;
+    /** HTTP status code from the endpoint. */
+    status_code: number | null;
+    /** Response body from the endpoint (truncated to 2000 chars). */
+    response_body: string | null;
+    /** Error message if delivery failed. */
+    error: string | null;
+}

package/dist/esm/types/webhook.js

@@ -0,0 +1,5 @@
+/**
+ * Webhook response types.
+ */
+export {};
+//# sourceMappingURL=webhook.js.map

package/dist/esm/types/webhook.js.map

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

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "listbee",
+  "version": "0.3.0",
+  "description": "Official TypeScript SDK for the ListBee API — one API call to sell and deliver digital content.",
+  "license": "Apache-2.0",
+  "homepage": "https://listbee.so",
+  "author": {
+    "name": "ListBee",
+    "email": "damian@listbee.so"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/listbee-dev/listbee-typescript.git"
+  },
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./api-keys": {
+      "import": {
+        "types": "./dist/esm/resources/api-keys.d.ts",
+        "default": "./dist/esm/resources/api-keys.js"
+      },
+      "require": {
+        "types": "./dist/cjs/resources/api-keys.d.ts",
+        "default": "./dist/cjs/resources/api-keys.js"
+      }
+    },
+    "./orders": {
+      "import": {
+        "types": "./dist/esm/resources/orders.d.ts",
+        "default": "./dist/esm/resources/orders.js"
+      },
+      "require": {
+        "types": "./dist/cjs/resources/orders.d.ts",
+        "default": "./dist/cjs/resources/orders.js"
+      }
+    },
+    "./signup": {
+      "import": {
+        "types": "./dist/esm/resources/signup.d.ts",
+        "default": "./dist/esm/resources/signup.js"
+      },
+      "require": {
+        "types": "./dist/cjs/resources/signup.d.ts",
+        "default": "./dist/cjs/resources/signup.js"
+      }
+    },
+    "./stripe": {
+      "import": {
+        "types": "./dist/esm/resources/stripe.d.ts",
+        "default": "./dist/esm/resources/stripe.js"
+      },
+      "require": {
+        "types": "./dist/cjs/resources/stripe.d.ts",
+        "default": "./dist/cjs/resources/stripe.js"
+      }
+    },
+    "./webhooks": {
+      "import": {
+        "types": "./dist/esm/resources/webhooks.d.ts",
+        "default": "./dist/esm/resources/webhooks.js"
+      },
+      "require": {
+        "types": "./dist/cjs/resources/webhooks.d.ts",
+        "default": "./dist/cjs/resources/webhooks.js"
+      }
+    },
+    "./errors": {
+      "import": {
+        "types": "./dist/esm/errors.d.ts",
+        "default": "./dist/esm/errors.js"
+      },
+      "require": {
+        "types": "./dist/cjs/errors.d.ts",
+        "default": "./dist/cjs/errors.js"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/esm/types/index.d.ts",
+        "default": "./dist/esm/types/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/index.d.ts",
+        "default": "./dist/cjs/types/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "listbee",
+    "commerce",
+    "digital-products",
+    "api",
+    "sdk"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "~5.4.0",
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^3.0.0"
+  }
+}