@nextblock-cms/ecom 0.0.10 → 0.8.1

package/lib/product-context.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+import { Product } from './types';
+export declare const ProductProvider: React.FC<{
+    product: Product;
+    children: React.ReactNode;
+}>;
+export declare const useProduct: () => Product;

package/lib/product-schema.d.ts

@@ -0,0 +1,73 @@
+import { z } from './zod-config';
+export declare const productSchema: z.ZodObject<{
+    product_type: z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+        physical: "physical";
+        digital: "digital";
+    }>, z.ZodLiteral<"">]> & z.ZodType<"physical" | "digital", "" | "physical" | "digital", z.core.$ZodTypeInternals<"physical" | "digital", "" | "physical" | "digital">>, z.ZodTransform<"physical" | "digital", "physical" | "digital">>;
+    payment_provider: z.ZodEnum<{
+        stripe: "stripe";
+        freemius: "freemius";
+    }>;
+    title: z.ZodString;
+    slug: z.ZodString;
+    sku: z.ZodString;
+    upc: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    price: z.ZodCoercedNumber<unknown>;
+    prices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodCoercedNumber<unknown>>>;
+    sale_price: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    sale_prices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+    sale_start_at: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    sale_end_at: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    stock: z.ZodCoercedNumber<unknown>;
+    meta_title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    meta_description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    short_description: z.ZodOptional<z.ZodString>;
+    description_json: z.ZodOptional<z.ZodAny>;
+    freemius_plan_id: z.ZodOptional<z.ZodString>;
+    freemius_product_id: z.ZodOptional<z.ZodString>;
+    trial_period_days: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    trial_requires_payment_method: z.ZodDefault<z.ZodBoolean>;
+    media_id: z.ZodOptional<z.ZodString>;
+    product_media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        media_id: z.ZodString;
+    }, z.core.$strip>>>;
+    category_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    is_taxable: z.ZodBoolean;
+    status: z.ZodEnum<{
+        draft: "draft";
+        active: "active";
+        archived: "archived";
+    }>;
+    language_id: z.ZodCoercedNumber<unknown>;
+    translation_group_id: z.ZodPipe<z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>, z.ZodTransform<string | undefined, string | undefined>>;
+    explicitly_removed_media_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    variation_attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        attribute_id: z.ZodString;
+        term_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        combination_key: z.ZodString;
+        sku: z.ZodString;
+        upc: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        price: z.ZodCoercedNumber<unknown>;
+        prices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodCoercedNumber<unknown>>>;
+        sale_price: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        sale_prices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+        sale_start_at: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        sale_end_at: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        stock_quantity: z.ZodCoercedNumber<unknown>;
+        main_media_id: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        main_image_url: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        attribute_term_ids: z.ZodArray<z.ZodString>;
+        selected_options: z.ZodArray<z.ZodObject<{
+            attribute_id: z.ZodString;
+            attribute_name: z.ZodString;
+            term_id: z.ZodString;
+            term_value: z.ZodString;
+            term_slug: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ProductFormValues = z.infer<typeof productSchema>;

package/lib/providers/freemius.d.ts

@@ -0,0 +1,49 @@
+import { PaymentProvider } from '../types';
+import { CheckoutSessionInput } from '../customer';
+export type FreemiusCheckoutCredentialEntry = {
+    publicKey?: string;
+    secretKey?: string;
+    apiKey?: string;
+};
+export declare function readFreemiusEnvValue(name: keyof NodeJS.ProcessEnv): string | null;
+export declare function parseFreemiusCheckoutCredentialsMap(): Record<string, FreemiusCheckoutCredentialEntry> | null;
+export declare function resolveFreemiusCheckoutCredentials(productId: string | number): {
+    publicKey: string;
+    secretKey: string | null;
+    apiKey: string | null;
+    source: "product-map";
+} | {
+    publicKey: string;
+    secretKey: string | null;
+    apiKey: string | null;
+    source: "single-product-sandbox-env";
+} | {
+    publicKey: string | null;
+    secretKey: string | null;
+    apiKey: string | null;
+    source: "single-product-env";
+} | {
+    publicKey: string | null;
+    secretKey: string | null;
+    apiKey: string | null;
+    source: "legacy-env";
+};
+export declare class FreemiusProvider implements PaymentProvider {
+    getProviderName(): string;
+    createCheckoutSession({ items: cartItems, customerEmail, customerPhone, userId, billingAddress, shippingAddress, currencyCode, couponCode, couponContextItems, }: CheckoutSessionInput): Promise<{
+        url: string | null;
+        error?: string;
+        errorKey?: string;
+        errorParams?: Record<string, string | number>;
+        errorStatus?: number;
+        customProps?: any;
+    }>;
+}
+export declare function syncFreemiusProductsToSupabase(): Promise<{
+    success: boolean;
+    count: number;
+}>;
+export declare function syncSingleFreemiusProduct(productId: string): Promise<{
+    success: boolean;
+    count: number;
+}>;

package/lib/providers/stripe.d.ts

@@ -0,0 +1,13 @@
+import { CheckoutSessionInput } from '../customer';
+import { PaymentProvider } from '../types';
+export declare class StripeProvider implements PaymentProvider {
+    getProviderName(): string;
+    createCheckoutSession({ items: cartItems, customerEmail, customerPhone, userId, billingAddress, shippingAddress, shippingMethodId, currencyCode, locale, couponCode, couponContextItems, }: CheckoutSessionInput): Promise<{
+        url: string | null;
+        error?: string;
+        errorKey?: string;
+        errorParams?: Record<string, string | number>;
+        errorStatus?: number;
+        customProps?: any;
+    }>;
+}

package/lib/server-actions/coupon-actions.d.ts

@@ -0,0 +1,17 @@
+import { CartItem } from '../types';
+export declare function getCouponQuoteAction(input: {
+    code?: string | null;
+    items: CartItem[];
+    currencyCode?: string | null;
+}): Promise<{
+    success: true;
+    quote: import('../coupons').CouponQuote;
+} | {
+    success: false;
+    error: string;
+    errorKey?: string;
+} | {
+    success: false;
+    error: any;
+    errorKey: string;
+}>;

package/lib/server-actions/customer-actions.d.ts

@@ -0,0 +1,18 @@
+import { CustomerAddressInput } from '../customer';
+export interface ProfileUpdateData {
+    full_name?: string;
+    avatar_url?: string;
+    website?: string;
+    github_username?: string;
+    phone?: string;
+    billing_address?: CustomerAddressInput | null;
+    shipping_address?: CustomerAddressInput | null;
+    use_billing_for_shipping?: boolean;
+}
+export declare function updateProfile(data: ProfileUpdateData): Promise<{
+    success: boolean;
+}>;
+export declare function validateCheckoutEligibility(userId: string): Promise<{
+    ready: boolean;
+    missingFields: string[];
+}>;

package/lib/server-actions/product-actions.d.ts

@@ -0,0 +1,69 @@
+export declare function getTranslatedProductsForCart(translationGroupIds: string[], languageCode: string, skus?: string[], productIds?: string[]): Promise<{
+    id: any;
+    title: any;
+    sku: any;
+    price: any;
+    prices: any;
+    sale_price: any;
+    sale_prices: any;
+    sale_start_at: any;
+    sale_end_at: any;
+    scheduled_price: any;
+    scheduled_prices: any;
+    scheduled_price_at: any;
+    stock: any;
+    slug: any;
+    language_id: any;
+    product_type: any;
+    payment_provider: any;
+    freemius_product_id: any;
+    freemius_plan_id: any;
+    trial_period_days: any;
+    trial_requires_payment_method: any;
+    is_taxable: any;
+    product_media: {
+        media: {
+            file_path: any;
+            object_key: any;
+        }[];
+    }[];
+    product_variants: {
+        id: any;
+        sku: any;
+        upc: any;
+        main_media_id: any;
+        price: any;
+        prices: any;
+        sale_price: any;
+        sale_prices: any;
+        sale_start_at: any;
+        sale_end_at: any;
+        scheduled_price: any;
+        scheduled_prices: any;
+        scheduled_price_at: any;
+        stock_quantity: any;
+        media: {
+            file_path: any;
+            object_key: any;
+            description: any;
+        }[];
+        variant_attribute_mapping: {
+            attribute_term_id: any;
+            product_attribute_terms: {
+                id: any;
+                attribute_id: any;
+                value: any;
+                slug: any;
+                sort_order: any;
+                value_translations: any;
+                product_attributes: {
+                    id: any;
+                    name: any;
+                    slug: any;
+                    name_translations: any;
+                }[];
+            }[];
+        }[];
+    }[];
+    translation_group_id: any;
+}[]>;

package/lib/server-actions/shipping-actions.d.ts

@@ -0,0 +1,10 @@
+import { ShippingDestination, ResolvedShippingMethod } from '../shipping/resolver';
+/**
+ * Server action to fetch shipping estimates from the client components (Cart/Checkout).
+ */
+export declare function getShippingEstimates(cartTotal: number, destination: ShippingDestination, languageCode?: string, currencyCode?: string): Promise<{
+    success: boolean;
+    methods?: ResolvedShippingMethod[];
+    error?: string;
+    errorKey?: string;
+}>;

package/lib/server-actions/tax-actions.d.ts

@@ -0,0 +1,7 @@
+import { CartItem, TaxCalculationResult } from '../types';
+import { TaxDestinationInput } from '../tax-calculation';
+export declare function getTaxEstimate(cartItems: CartItem[], destination?: TaxDestinationInput | null, currencyCode?: string, couponCode?: string | null, couponContextItems?: CartItem[]): Promise<{
+    success: boolean;
+    tax?: TaxCalculationResult;
+    error?: string;
+}>;

package/lib/shared-inventory.d.ts

@@ -0,0 +1,38 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+import { Database } from '../../../db/src/index.ts';
+import { ProductFormValues } from './product-schema';
+export type InventoryUsageType = 'product' | 'variant' | 'mixed';
+export interface InventoryItem {
+    key: string;
+    sku: string;
+    stock: number;
+    usageType: InventoryUsageType;
+    productTitles: string[];
+    parentProductSkus: string[];
+    languages: string[];
+    statuses: string[];
+    productIds: string[];
+    variantIds: string[];
+}
+interface InventoryQuantityUpdateInput {
+    sku: string;
+    stock: number;
+}
+export declare function getInventoryItems(client?: SupabaseClient<Database>): Promise<{
+    key: string;
+    sku: string;
+    stock: number;
+    usageType: InventoryUsageType;
+    productTitles: string[];
+    parentProductSkus: string[];
+    languages: string[];
+    statuses: string[];
+    productIds: string[];
+    variantIds: string[];
+}[]>;
+export declare function setSharedInventoryQuantity(input: InventoryQuantityUpdateInput, client?: SupabaseClient<Database>): Promise<{
+    stock: number;
+    affectedCount: number;
+}>;
+export declare function syncSharedInventoryForSavedProduct(productId: string, data: Pick<ProductFormValues, 'sku' | 'stock' | 'variants'>, client?: SupabaseClient<Database>): Promise<void>;
+export {};

package/lib/shipping/resolver.d.ts

@@ -0,0 +1,16 @@
+export interface ShippingDestination {
+    country: string;
+    state?: string;
+    postal_code?: string;
+}
+export interface ResolvedShippingMethod {
+    id: string;
+    name: string;
+    amount: number;
+    currency: string;
+    type: 'flat_rate' | 'free_shipping';
+}
+/**
+ * Resolves available shipping methods based on destination and cart value.
+ */
+export declare function resolveShippingOptions(cartTotal: number, destination: ShippingDestination, languageCode?: string | null, currencyCode?: string | null): Promise<ResolvedShippingMethod[]>;

package/lib/shipping-rate-currency.d.ts

@@ -0,0 +1,39 @@
+import { CurrencyRecord, PriceMap } from './currency';
+export declare const SHIPPING_RATE_CURRENCY_MODES: readonly ["auto", "manual"];
+export type ShippingRateCurrencyMode = (typeof SHIPPING_RATE_CURRENCY_MODES)[number];
+export declare function normalizeShippingRateCurrencyMode(value: unknown): ShippingRateCurrencyMode;
+export declare function sanitizeShippingRateAmountMaps(params: {
+    currencies: CurrencyRecord[];
+    mode?: unknown;
+    sourceCurrencyCode?: string | null;
+    costAmounts?: PriceMap | null;
+    minOrderAmounts?: PriceMap | null;
+    fallbackCostAmount?: number | null;
+    fallbackMinOrderAmount?: number | null;
+}): {
+    mode: "auto";
+    sourceCurrencyCode: any;
+    costAmounts: {
+        [x: number]: number;
+    };
+    minOrderAmounts: {
+        [x: number]: number;
+    };
+} | {
+    mode: "manual";
+    sourceCurrencyCode: any;
+    costAmounts: {
+        [x: string]: number;
+    };
+    minOrderAmounts: {
+        [x: string]: number;
+    };
+};
+export declare function resolveShippingRateAmountForCurrency(params: {
+    currencies: CurrencyRecord[];
+    mode?: unknown;
+    amountMap?: PriceMap | null;
+    fallbackAmount?: number | null;
+    sourceCurrencyCode?: string | null;
+    currencyCode?: string | null;
+}): any;

package/lib/states.d.ts

@@ -0,0 +1,9 @@
+export interface CountrySubdivision {
+    code: string;
+    name: string;
+}
+export declare const STATES_BY_COUNTRY: Record<string, CountrySubdivision[]>;
+export declare function getStatesForCountry(countryCode?: string | null): CountrySubdivision[];
+export declare function countryUsesStructuredStates(countryCode?: string | null): boolean;
+export declare function normalizeSubdivisionCode(countryCode?: string | null, stateCodeOrName?: string | null): string | null;
+export declare function resolveSubdivisionName(countryCode?: string | null, stateCode?: string | null): string | null;

package/lib/stripe/checkout.d.ts

@@ -0,0 +1,6 @@
+import { CartItem } from '../types';
+import { ShippingDestination } from '../shipping/resolver';
+export declare const createCheckoutSession: (cartItems: CartItem[], userId?: string, destination?: ShippingDestination, currencyCode?: string) => Promise<{
+    url: string | null;
+    error?: string;
+}>;

package/lib/stripe/client.d.ts

@@ -0,0 +1,2 @@
+import { default as Stripe } from 'stripe';
+export declare const stripe: Stripe;

package/lib/stripe/order-sync.d.ts

@@ -0,0 +1,18 @@
+import { default as Stripe } from 'stripe';
+import { OrderCustomerDetails } from '../customer';
+export declare function syncStripeOrderFromSession(session: Stripe.Checkout.Session): Promise<{
+    orderId: any;
+    alreadyPaid: boolean;
+    customerDetails: OrderCustomerDetails;
+    order: {
+        id: any;
+        invoice_number: any;
+        paid_at: any;
+        total: any;
+        currency: any;
+        subtotal: any;
+        shipping_total: any;
+        tax_total: number;
+        tax_details: import('../order-tax-details').OrderTaxDetails;
+    };
+}>;

package/lib/stripe/webhooks.d.ts

@@ -0,0 +1,4 @@
+export declare const handleStripeWebhook: (signature: string, body: string | Buffer) => Promise<{
+    received: boolean;
+    error?: string;
+}>;

package/lib/tax-calculation.d.ts

@@ -0,0 +1,23 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+import { CurrencyRecord } from './currency';
+import { CartItem, TaxCalculationResult } from './types';
+export interface CheckoutTaxableItem {
+    product_id: string;
+    quantity: number;
+    unit_amount: number;
+    discount_amount?: number;
+    is_taxable: boolean;
+}
+export interface TaxDestinationInput {
+    country_code?: string | null;
+    state?: string | null;
+}
+export declare const STRIPE_TAX_CODE_TAXABLE_GOODS = "txcd_99999999";
+export declare const STRIPE_TAX_CODE_NONTAXABLE = "txcd_00000000";
+export declare const STRIPE_TAX_CODE_SHIPPING = "txcd_92010001";
+export declare function getStripeTaxCodeForProduct(isTaxable: boolean): "txcd_99999999" | "txcd_00000000";
+export declare function buildCheckoutTaxableItemsFromCart(supabase: SupabaseClient<any>, cartItems: CartItem[], currencyCode: string, currencies: CurrencyRecord[], lineDiscounts?: Map<string, number>): Promise<CheckoutTaxableItem[]>;
+export declare function calculateCheckoutTaxes(supabase: SupabaseClient<any>, input: {
+    items: CheckoutTaxableItem[];
+    destination?: TaxDestinationInput | null;
+}): Promise<TaxCalculationResult>;

package/lib/trials.d.ts

@@ -0,0 +1,15 @@
+export type FreemiusTrialMode = 'free' | 'paid';
+type TrialCarrier = {
+    trial_period_days?: number | string | null;
+    trial_requires_payment_method?: boolean | null;
+};
+export declare function getTrialPeriodDays(value: TrialCarrier | null | undefined): number;
+export declare function getTrialCheckoutMode(value: TrialCarrier | null | undefined): FreemiusTrialMode | null;
+export declare function getTrialLabel(value: TrialCarrier | number | null | undefined): string | null;
+export declare function getTrialPaymentRequirementLabel(value: TrialCarrier | null | undefined): "Payment method required" | "No credit card required";
+export declare function getTrialSummary(value: TrialCarrier | null | undefined): {
+    label: string;
+    paymentRequirementLabel: string;
+    checkoutMode: FreemiusTrialMode | null;
+} | null;
+export {};