@develemit/commerce-admin 0.4.0 → 0.7.0

package/dist/lib/admin-labels.d.ts

@@ -15,6 +15,8 @@ export interface AdminLabels {
         products: string;
         orders: string;
         shippingRates: string;
+        more: string;
+        closeMore: string;
     };
     statuses: Record<string, string>;
     errors: Record<AdminErrorKey, string>;

package/dist/lib/discount-labels.d.ts

@@ -7,6 +7,7 @@ export interface DiscountLabels {
     tabs: Record<DiscountTab, string>;
     empty: Record<DiscountTab, string>;
     noMatches: string;
+    emptyHint: string;
     loadMore: string;
     columns: {
         code: string;

package/dist/lib/fill-alts.d.ts

@@ -0,0 +1,3 @@
+import { AdminProduct } from '@develemit/commerce-contracts';
+import { AdminClient } from '../client';
+export declare function fillBlankAlts(client: AdminClient, product: AdminProduct, template: string): Promise<AdminProduct>;

package/dist/lib/order-labels.d.ts

@@ -7,6 +7,7 @@ export interface OrderLabels {
     tabs: Record<OrderTab, string>;
     empty: Record<OrderTab, string>;
     noMatches: string;
+    emptyHint: string;
     loadMore: string;
     columns: {
         order: string;

package/dist/lib/product-draft.d.ts

@@ -0,0 +1,11 @@
+import { AdminProduct, AdminProductInput, AdminProductPatch } from '@develemit/commerce-contracts';
+import { ProductForm } from './product-form';
+export declare function hasDraftContent(form: ProductForm): boolean;
+export declare function draftInput(form: ProductForm, currency?: string): AdminProductInput;
+export declare function draftPatch(base: AdminProduct, form: ProductForm): AdminProductPatch;
+export declare function basicsReady(form: ProductForm): boolean;
+export declare function splitMaterials(value: string): string[];
+export declare function toggleMaterial(value: string, material: string): string;
+export declare function appendPrompt(description: string, prompt: string): string;
+export declare function currencySymbol(locale: string, currency: string): string;
+export declare function fillText(template: string, values: Record<string, string>): string;

package/dist/lib/product-flow-labels.d.ts

@@ -0,0 +1,54 @@
+export type ProductFlowStep = 'photos' | 'basics' | 'story' | 'preview';
+export declare const PRODUCT_FLOW_STEPS: ProductFlowStep[];
+export interface ProductFlowLabels {
+    newTitle: string;
+    editTitle: string;
+    back: string;
+    close: string;
+    stepsLabel: string;
+    steps: Record<ProductFlowStep, string>;
+    headings: Record<ProductFlowStep, string>;
+    ledes: Record<ProductFlowStep, string>;
+    addPhotos: string;
+    addMorePhotos: string;
+    photoHint: string;
+    photoTip: string;
+    photoN: string;
+    cover: string;
+    makeCover: string;
+    removePhoto: string;
+    uploading: string;
+    pricePlaceholder: string;
+    otherCategory: string;
+    newCategory: string;
+    oneOfAKind: string;
+    howMany: string;
+    descriptionPrompts: string[];
+    materialsOther: string;
+    size: string;
+    altTitle: string;
+    altHelp: string;
+    altFallback: string;
+    inTheShop: string;
+    untitled: string;
+    noPhoto: string;
+    needs: string;
+    featured: string;
+    continue: string;
+    photosLater: string;
+    skip: string;
+    saveDraft: string;
+    publish: string;
+    done: string;
+    saving: string;
+    savedNew: string;
+    savedEdit: string;
+    saveFailed: string;
+    retry: string;
+    savedAsDraft: string;
+    success: string;
+    successFirst: string;
+    addAnother: string;
+    backToList: string;
+}
+export declare const defaultProductFlowLabels: ProductFlowLabels;

package/dist/lib/product-labels.d.ts

@@ -1,4 +1,6 @@
+import { StockLabels } from './stock-labels';
 import { ImageLabels } from './image-labels';
+import { ProductFlowLabels } from './product-flow-labels';
 export type ProductFilter = 'all' | 'live' | 'sold' | 'draft' | 'archived';
 export interface ProductLabels {
     title: string;
@@ -9,6 +11,55 @@ export interface ProductLabels {
     empty: Record<ProductFilter, string>;
     noMatches: string;
     loadMore: string;
+    welcome: {
+        title: string;
+        body: string;
+        addFirst: string;
+        addMany: string;
+    };
+    card: {
+        needsPrice: string;
+        needsCategory: string;
+        needsPhoto: string;
+        featured: string;
+        noPhoto: string;
+    };
+    draftsBanner: {
+        one: string;
+        many: string;
+        finish: string;
+    };
+    sheet: {
+        close: string;
+        photoOf: string;
+        previousPhoto: string;
+        nextPhoto: string;
+        noPhoto: string;
+        category: string;
+        noCategory: string;
+        primary: Record<'finish' | 'publish' | 'sold' | 'restock' | 'restore', string>;
+        edit: string;
+        photos: string;
+        featureOn: string;
+        featureOff: string;
+        hide: string;
+        copyLink: string;
+        linkCopied: string;
+        archive: string;
+        undo: string;
+        missingTitle: string;
+        missing: Record<string, string>;
+        done: Record<'publish' | 'sold' | 'restock' | 'restore' | 'hide' | 'archive' | 'feature', string>;
+    };
+    openSearch: string;
+    closeSearch: string;
+    setup: {
+        title: string;
+        progress: string;
+        show: string;
+        hide: string;
+        locked: string;
+    };
     columns: {
         image: string;
         name: string;
@@ -41,6 +92,8 @@ export interface ProductLabels {
         featured: string;
     };
     images: ImageLabels;
+    flow: ProductFlowLabels;
+    stock: StockLabels;
     statusHelp: string;
     priceHelp: string;
     validation: {

package/dist/lib/product-missing.d.ts

@@ -0,0 +1,4 @@
+import { AdminProduct } from '@develemit/commerce-contracts';
+import { ProductLabels } from './product-labels';
+export declare function missingDetail(product: AdminProduct, copy: ProductLabels['card']): string | null;
+export declare function fillCount(template: string, values: Record<string, number>): string;

package/dist/lib/product-sheet-actions.d.ts

@@ -0,0 +1,13 @@
+import { AdminProduct, AdminProductPatch } from '@develemit/commerce-contracts';
+export type PrimaryKind = 'finish' | 'publish' | 'sold' | 'restock' | 'restore';
+export interface ProductChange {
+    patch: AdminProductPatch;
+    undo: AdminProductPatch;
+}
+export declare function isDraftComplete(product: AdminProduct): boolean;
+export declare function primaryKind(product: AdminProduct): PrimaryKind;
+export declare function primaryChange(product: AdminProduct, kind: PrimaryKind): ProductChange | null;
+export declare const hideChange: ProductChange;
+export declare function archiveChange(product: AdminProduct): ProductChange;
+export declare function featureChange(product: AdminProduct): ProductChange;
+export declare const canFeature: (product: AdminProduct) => boolean;

package/dist/lib/shipping-labels.d.ts

@@ -1,7 +1,9 @@
 export interface ShippingLabels {
     title: string;
     loading: string;
+    emptyTitle: string;
     empty: string;
+    addOption: string;
     add: string;
     save: string;
     saved: string;

package/dist/lib/stock-labels.d.ts

@@ -0,0 +1,41 @@
+export interface StockLabels {
+    addSeveral: {
+        title: string;
+        introTitle: string;
+        introBody: string;
+        choose: string;
+        progress: string;
+        failedTitle: string;
+        retry: string;
+        continueWithout: string;
+        doneTitle: string;
+        doneBody: string;
+        next: string;
+    };
+    queue: {
+        title: string;
+        pieceOf: string;
+        addPhoto: string;
+        coverAlt: string;
+        skip: string;
+        next: string;
+        review: string;
+        back: string;
+        loading: string;
+        nothingToFinish: string;
+        done: string;
+    };
+    summary: {
+        title: string;
+        lede: string;
+        needsDetails: string;
+        untitled: string;
+        publish: string;
+        keepDrafts: string;
+        stillIncomplete: string;
+        publishedTitle: string;
+        publishedBody: string;
+        allSkipped: string;
+    };
+}
+export declare const defaultStockLabels: StockLabels;

package/dist/lib/use-batch-upload.d.ts

@@ -0,0 +1,38 @@
+import { AdminProduct } from '@develemit/commerce-contracts';
+export interface BatchItem {
+    id: number;
+    file: File;
+    status: 'queued' | 'uploading' | 'done' | 'error';
+    productId?: string;
+    product?: AdminProduct;
+    reason?: string;
+    error?: unknown;
+}
+export declare function useBatchUpload(): {
+    items: BatchItem[];
+    add: (files: File[]) => void;
+    retry: () => void;
+    done: BatchItem[];
+    failed: BatchItem[];
+    settled: boolean;
+    products: {
+        id: string;
+        slug: string;
+        name: string;
+        description: string;
+        materials: string | null;
+        dimensions: string | null;
+        priceCents: number | null;
+        currency: string;
+        category: string | null;
+        quantity: number;
+        status: "draft" | "active" | "archived";
+        featured: boolean;
+        images: {
+            id: string;
+            url: string;
+            alt: string;
+            position: number;
+        }[];
+    }[];
+};

package/dist/lib/use-focus-trap.d.ts

@@ -0,0 +1,2 @@
+import { KeyboardEvent, RefObject } from 'react';
+export declare function useFocusTrap(ref: RefObject<HTMLElement | null>, active: boolean, onEscape: () => void): (event: KeyboardEvent) => void;

package/dist/lib/use-image-upload.d.ts

@@ -7,10 +7,11 @@ export interface UploadEntry {
     error?: unknown;
 }
 interface Options {
-    productId: string;
+    productId?: string;
+    resolveProductId?: () => Promise<string>;
     onUploaded: (product: AdminProduct) => void;
 }
-export declare function useImageUpload({ productId, onUploaded }: Options): {
+export declare function useImageUpload({ productId, resolveProductId, onUploaded, }: Options): {
     entries: UploadEntry[];
     upload: (files: File[], alt: string) => void;
     dismiss: (id: number) => void;

package/dist/lib/use-order-pages.d.ts

@@ -9,9 +9,11 @@ export declare function useOrderPages(query: Omit<AdminOrderQuery, 'cursor'>): {
         itemCount: number;
         createdAt: string;
     }[];
+    loaded: boolean;
     loading: boolean;
     error: unknown;
     hasMore: boolean;
     loadingMore: boolean;
+    reload: () => void;
     loadMore: () => void;
 };

package/dist/lib/use-paged-list.d.ts

@@ -0,0 +1,15 @@
+interface CursorPage<Item> {
+    items: Item[];
+    nextCursor: string | null;
+}
+export declare function usePagedList<Item, Page extends CursorPage<Item>>(key: readonly unknown[], fetchPage: (cursor?: string) => Promise<Page>): {
+    items: Item[];
+    loaded: boolean;
+    loading: boolean;
+    error: unknown;
+    hasMore: boolean;
+    loadingMore: boolean;
+    reload: () => void;
+    loadMore: () => void;
+};
+export {};

package/dist/lib/use-product-autosave.d.ts

@@ -0,0 +1,95 @@
+import { AdminProduct } from '@develemit/commerce-contracts';
+import { ProductForm } from './product-form';
+export type AutosaveState = 'idle' | 'saving' | 'saved' | 'error';
+interface Options {
+    initial: AdminProduct | null;
+    form: ProductForm;
+    currency?: string;
+    delayMs?: number;
+}
+export declare function useProductAutosave({ initial, form, currency, delayMs, }: Options): {
+    product: {
+        id: string;
+        slug: string;
+        name: string;
+        description: string;
+        materials: string | null;
+        dimensions: string | null;
+        priceCents: number | null;
+        currency: string;
+        category: string | null;
+        quantity: number;
+        status: "draft" | "active" | "archived";
+        featured: boolean;
+        images: {
+            id: string;
+            url: string;
+            alt: string;
+            position: number;
+        }[];
+    } | null;
+    setProduct: (next: AdminProduct) => void;
+    state: AutosaveState;
+    error: unknown;
+    flush: () => Promise<{
+        id: string;
+        slug: string;
+        name: string;
+        description: string;
+        materials: string | null;
+        dimensions: string | null;
+        priceCents: number | null;
+        currency: string;
+        category: string | null;
+        quantity: number;
+        status: "draft" | "active" | "archived";
+        featured: boolean;
+        images: {
+            id: string;
+            url: string;
+            alt: string;
+            position: number;
+        }[];
+    } | null>;
+    ensureProduct: () => Promise<{
+        id: string;
+        slug: string;
+        name: string;
+        description: string;
+        materials: string | null;
+        dimensions: string | null;
+        priceCents: number | null;
+        currency: string;
+        category: string | null;
+        quantity: number;
+        status: "draft" | "active" | "archived";
+        featured: boolean;
+        images: {
+            id: string;
+            url: string;
+            alt: string;
+            position: number;
+        }[];
+    }>;
+    retry: () => Promise<{
+        id: string;
+        slug: string;
+        name: string;
+        description: string;
+        materials: string | null;
+        dimensions: string | null;
+        priceCents: number | null;
+        currency: string;
+        category: string | null;
+        quantity: number;
+        status: "draft" | "active" | "archived";
+        featured: boolean;
+        images: {
+            id: string;
+            url: string;
+            alt: string;
+            position: number;
+        }[];
+    } | null>;
+};
+export {};

package/dist/lib/use-product-pages.d.ts

@@ -7,9 +7,9 @@ export declare function useProductPages(query: Omit<AdminProductQuery, 'cursor'>
         description: string;
         materials: string | null;
         dimensions: string | null;
-        priceCents: number;
+        priceCents: number | null;
         currency: string;
-        category: string;
+        category: string | null;
         quantity: number;
         status: "draft" | "active" | "archived";
         featured: boolean;