commerceforai 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -200,6 +200,29 @@ declare class Discounts extends Resource {
     }>>;
 }
 declare class Reports extends Resource {
+    /** 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 +570,32 @@ 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;
+        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 +618,8 @@ 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;
         default_success_url?: string | null;
         default_cancel_url?: string | null;
         builtin_emails?: boolean;

package/dist/index.js

@@ -240,6 +240,10 @@ class Discounts extends Resource {
     delete(idOrCode) { return this.client.request("DELETE", `/v1/discounts/${encodeURIComponent(idOrCode)}`); }
 }
 class Reports extends Resource {
+    /** 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 +366,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.1",
   "description": "Commerce for apps built by AI. Products, inventory, checkout and orders on top of your Stripe account.",
   "type": "module",
   "main": "./dist/index.js",