commerceforai 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -200,6 +200,53 @@ declare class Discounts extends Resource {
     }>>;
 }
 declare class Reports extends Resource {
+    /** Every order with its tax, for an accountant. Dates are YYYY-MM-DD (default: the last 365 days). */
+    taxOrders(params?: {
+        from?: string;
+        to?: string;
+    }): Promise<Result<{
+        object: "list";
+        truncated: boolean;
+        data: {
+            order_number: number;
+            date: string;
+            status: string;
+            city: string | null;
+            state: string | null;
+            postal_code: string | null;
+            country: string | null;
+            subtotal: number;
+            discount: number;
+            shipping: number;
+            tax: number;
+            total: number;
+            refunded: number;
+            currency: string;
+        }[];
+    }>>;
+    /** Sales and tax by state over the last `days` (default 365). `watch` flags US states near common registration thresholds. */
+    tax(params?: {
+        days?: number;
+    }): Promise<Result<{
+        object: "tax_report";
+        days: number;
+        currency: string;
+        note: string;
+        totals: {
+            sales: number;
+            tax_collected: number;
+            orders: number;
+        };
+        data: {
+            country: string;
+            state: string | null;
+            orders: number;
+            sales: number;
+            tax_collected: number;
+            registered: boolean;
+            watch: boolean;
+        }[];
+    }>>;
     /** Sales over the last `days` (default 30, max 366): totals vs the previous period, a time series and top products. */
     sales(params?: {
         days?: number;
@@ -547,6 +594,39 @@ declare class StoreResource extends Resource {
      * Note on `tax_enabled`: Stripe only collects tax in jurisdictions where you have an active
      * tax registration in Stripe Tax. Turning this on without registrations collects $0 tax.
      */
+    /** Sales tax readiness: Stripe Tax status, registrations, what to do next, and the tax categories to choose from. */
+    tax(): Promise<Result<{
+        object: "tax_overview";
+        enabled: boolean;
+        default_tax_code: string | null;
+        prices_include_tax: boolean;
+        links: {
+            registrations: string;
+            thresholds: string;
+            filing: string;
+            transactions: string;
+        } | null;
+        collecting: boolean;
+        next_step: string | null;
+        fix_url: string | null;
+        note: string;
+        stripe: {
+            status: string;
+            missing_fields: string[];
+            registrations: {
+                country: string;
+                state: string | null;
+            }[];
+        };
+        last_error: {
+            message: string;
+            at: string;
+        } | null;
+        categories: {
+            code: string;
+            name: string;
+        }[];
+    }>>;
     /**
      * Preview a sync from this store's other version (test or live) into this store. Nothing changes.
      * Syncs cover products, prices, images, collections, discounts and shipping/email settings; never orders, keys, Stripe, site URLs or stock counts.
@@ -569,7 +649,9 @@ declare class StoreResource extends Resource {
     }>>;
     update(params: {
         name?: string;
-        tax_enabled?: boolean;
+        tax_enabled?: boolean; /** Stripe tax code for products without their own, e.g. "txcd_30011000" (clothing). */
+        default_tax_code?: string | null;
+        /** Your prices already include tax (common outside the US). */ prices_include_tax?: boolean;
         default_success_url?: string | null;
         default_cancel_url?: string | null;
         builtin_emails?: boolean;

package/dist/index.js

@@ -240,6 +240,14 @@ class Discounts extends Resource {
     delete(idOrCode) { return this.client.request("DELETE", `/v1/discounts/${encodeURIComponent(idOrCode)}`); }
 }
 class Reports extends Resource {
+    /** Every order with its tax, for an accountant. Dates are YYYY-MM-DD (default: the last 365 days). */
+    taxOrders(params = {}) {
+        return this.client.request("GET", "/v1/reports/tax/orders", { query: params });
+    }
+    /** Sales and tax by state over the last `days` (default 365). `watch` flags US states near common registration thresholds. */
+    tax(params = {}) {
+        return this.client.request("GET", "/v1/reports/tax", { query: params });
+    }
     /** Sales over the last `days` (default 30, max 366): totals vs the previous period, a time series and top products. */
     sales(params = {}) { return this.client.request("GET", "/v1/reports/sales", { query: params }); }
 }
@@ -362,6 +370,10 @@ class StoreResource extends Resource {
      * Note on `tax_enabled`: Stripe only collects tax in jurisdictions where you have an active
      * tax registration in Stripe Tax. Turning this on without registrations collects $0 tax.
      */
+    /** Sales tax readiness: Stripe Tax status, registrations, what to do next, and the tax categories to choose from. */
+    tax() {
+        return this.client.request("GET", "/v1/store/tax");
+    }
     /**
      * Preview a sync from this store's other version (test or live) into this store. Nothing changes.
      * Syncs cover products, prices, images, collections, discounts and shipping/email settings; never orders, keys, Stripe, site URLs or stock counts.

package/dist/types.d.ts

@@ -89,6 +89,8 @@ export interface VariantFulfillment {
 }
 export type ProductCreateParams = {
     name: string;
+    /** Stripe Tax category, e.g. "txcd_30011000" (clothing). Defaults to the store's default_tax_code. */
+    tax_code?: string | null;
     /** Default artwork for every variant — artwork is usually per design, not per size. */
     print_files?: PrintFile[];
     description?: string;
@@ -107,6 +109,8 @@ export type ProductCreateParams = {
     variants?: never;
 });
 export interface ProductUpdateParams {
+    /** Stripe Tax category; null falls back to the store's default_tax_code. */
+    tax_code?: string | null;
     name?: string;
     print_files?: PrintFile[] | null;
     description?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commerceforai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Commerce for apps built by AI. Products, inventory, checkout and orders on top of your Stripe account.",
   "type": "module",
   "main": "./dist/index.js",