@purveyors/cli 0.2.1 → 0.4.0

package/dist/lib/sales.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import type { SupabaseClient } from '@supabase/supabase-js';
+export interface Sale {
+    id: number;
+    roast_id: number | null;
+    oz_sold: number | null;
+    sale_price: number | null;
+    buyer: string | null;
+    sell_date: string | null;
+    user: string;
+    last_updated: string;
+}
+export declare const SALE_SELECT = "id, roast_id, oz_sold, sale_price, buyer, sell_date, user, last_updated";
+export declare const listSalesSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ListSalesInput = z.input<typeof listSalesSchema>;
+export declare const recordSaleSchema: z.ZodObject<{
+    roastId: z.ZodNumber;
+    oz: z.ZodNumber;
+    price: z.ZodNumber;
+    buyer: z.ZodOptional<z.ZodString>;
+    sellDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RecordSaleInput = z.input<typeof recordSaleSchema>;
+export declare const updateSaleSchema: z.ZodObject<{
+    oz: z.ZodOptional<z.ZodNumber>;
+    price: z.ZodOptional<z.ZodNumber>;
+    buyer: z.ZodOptional<z.ZodString>;
+    sellDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateSaleInput = z.input<typeof updateSaleSchema>;
+export declare const deleteSaleSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strip>;
+export type DeleteSaleInput = z.input<typeof deleteSaleSchema>;
+/**
+ * List sales for a user (newest first, with roast profile join).
+ */
+export declare function listSales(supabase: SupabaseClient, userId: string, opts?: ListSalesInput): Promise<Sale[]>;
+/**
+ * Record a new sale (roastId must belong to userId).
+ */
+export declare function recordSale(supabase: SupabaseClient, userId: string, input: RecordSaleInput): Promise<Sale>;
+/**
+ * Update an existing sale (must belong to userId).
+ */
+export declare function updateSale(supabase: SupabaseClient, userId: string, id: number, input: UpdateSaleInput): Promise<Sale>;
+/**
+ * Delete a sale (must belong to userId).
+ */
+export declare function deleteSale(supabase: SupabaseClient, userId: string, id: number): Promise<void>;
+//# sourceMappingURL=sales.d.ts.map

package/dist/lib/sales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales.d.ts","sourceRoot":"","sources":["../../src/lib/sales.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,eAAO,MAAM,WAAW,4EACmD,CAAC;AAI5E,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;;;;iBAM3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,gBAAgB;;;;;iBASzB,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI/D;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,IAAI,EAAE,CAAC,CAajB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/lib/sales.js

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import { AuthError, PrvrsError } from './errors.js';
+// ─── Shared select columns ────────────────────────────────────────────────────
+export const SALE_SELECT = 'id, roast_id, oz_sold, sale_price, buyer, sell_date, user, last_updated';
+// ─── Zod schemas ──────────────────────────────────────────────────────────────
+export const listSalesSchema = z.object({
+    limit: z.number().int().min(1).default(20),
+});
+export const recordSaleSchema = z.object({
+    roastId: z.number().int().positive(),
+    oz: z.number().positive(),
+    price: z.number().min(0),
+    buyer: z.string().optional(),
+    sellDate: z.string().optional(),
+});
+export const updateSaleSchema = z
+    .object({
+    oz: z.number().positive().optional(),
+    price: z.number().min(0).optional(),
+    buyer: z.string().optional(),
+    sellDate: z.string().optional(),
+})
+    .refine((v) => Object.keys(v).some((k) => v[k] !== undefined), {
+    message: 'No update fields provided. Pass at least one of: oz, price, buyer, sellDate.',
+});
+export const deleteSaleSchema = z.object({
+    id: z.number().int().positive(),
+});
+// ─── Pure lib functions ───────────────────────────────────────────────────────
+/**
+ * List sales for a user (newest first, with roast profile join).
+ */
+export async function listSales(supabase, userId, opts = {}) {
+    const parsed = listSalesSchema.parse(opts);
+    const { data, error } = await supabase
+        .from('sales')
+        .select(`${SALE_SELECT}, roast_profiles!roast_id (batch_name, coffee_name)`)
+        .eq('user', userId)
+        .order('sell_date', { ascending: false })
+        .limit(parsed.limit);
+    if (error)
+        throw error;
+    return (data ?? []);
+}
+/**
+ * Record a new sale (roastId must belong to userId).
+ */
+export async function recordSale(supabase, userId, input) {
+    const parsed = recordSaleSchema.parse(input);
+    const todayIso = () => new Date().toISOString().slice(0, 10);
+    // Verify the roast profile belongs to the user
+    const { data: roastExists, error: roastError } = await supabase
+        .from('roast_profiles')
+        .select('roast_id')
+        .eq('roast_id', parsed.roastId)
+        .eq('user', userId)
+        .single();
+    if (roastError || !roastExists) {
+        throw new AuthError(`Roast profile ${parsed.roastId} not found or does not belong to you.`);
+    }
+    const insertPayload = {
+        user: userId,
+        roast_id: parsed.roastId,
+        oz_sold: parsed.oz,
+        sale_price: parsed.price,
+        sell_date: parsed.sellDate ?? todayIso(),
+    };
+    if (parsed.buyer !== undefined)
+        insertPayload.buyer = parsed.buyer;
+    const { data: inserted, error: insertError } = await supabase
+        .from('sales')
+        .insert(insertPayload)
+        .select('id')
+        .single();
+    if (insertError)
+        throw insertError;
+    // Re-fetch the full row with roast join
+    const { data, error } = await supabase
+        .from('sales')
+        .select(`${SALE_SELECT}, roast_profiles!roast_id (batch_name, coffee_name)`)
+        .eq('id', inserted.id)
+        .single();
+    if (error)
+        throw error;
+    return data;
+}
+/**
+ * Update an existing sale (must belong to userId).
+ */
+export async function updateSale(supabase, userId, id, input) {
+    deleteSaleSchema.parse({ id });
+    const parsed = updateSaleSchema.parse(input);
+    // Verify ownership
+    const { data: existing, error: fetchError } = await supabase
+        .from('sales')
+        .select('id')
+        .eq('id', id)
+        .eq('user', userId)
+        .single();
+    if (fetchError || !existing) {
+        throw new AuthError(`Sale ${id} not found or does not belong to you.`);
+    }
+    const updates = {};
+    if (parsed.oz !== undefined)
+        updates.oz_sold = parsed.oz;
+    if (parsed.price !== undefined)
+        updates.sale_price = parsed.price;
+    if (parsed.buyer !== undefined)
+        updates.buyer = parsed.buyer;
+    if (parsed.sellDate !== undefined)
+        updates.sell_date = parsed.sellDate;
+    if (Object.keys(updates).length === 0) {
+        throw new PrvrsError('INVALID_ARGUMENT', 'No update fields provided. Pass at least one of: oz, price, buyer, sellDate.');
+    }
+    const { error: updateError } = await supabase
+        .from('sales')
+        .update(updates)
+        .eq('id', id)
+        .eq('user', userId);
+    if (updateError)
+        throw updateError;
+    // Re-fetch the updated row
+    const { data, error } = await supabase
+        .from('sales')
+        .select(`${SALE_SELECT}, roast_profiles!roast_id (batch_name, coffee_name)`)
+        .eq('id', id)
+        .single();
+    if (error)
+        throw error;
+    return data;
+}
+/**
+ * Delete a sale (must belong to userId).
+ */
+export async function deleteSale(supabase, userId, id) {
+    deleteSaleSchema.parse({ id });
+    // Verify ownership
+    const { data: existing, error: fetchError } = await supabase
+        .from('sales')
+        .select('id')
+        .eq('id', id)
+        .eq('user', userId)
+        .single();
+    if (fetchError || !existing) {
+        throw new AuthError(`Sale ${id} not found or does not belong to you.`);
+    }
+    const { error: deleteError } = await supabase
+        .from('sales')
+        .delete()
+        .eq('id', id)
+        .eq('user', userId);
+    if (deleteError)
+        throw deleteError;
+}
+//# sourceMappingURL=sales.js.map

package/dist/lib/sales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales.js","sourceRoot":"","sources":["../../src/lib/sales.ts"],"names":[],"mappings":"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"}

package/dist/lib/tasting.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import type { SupabaseClient } from '@supabase/supabase-js';
+import type { InventoryItem } from './inventory.js';
+export type TastingFilter = 'user' | 'supplier' | 'both';
+export interface SupplierTastingNotes {
+    source: 'supplier';
+    catalogId: number;
+    name: string | null;
+    processing: string | null;
+    region: string | null;
+    cupping_notes: string | null;
+    ai_tasting_notes: unknown | null;
+    ai_description: string | null;
+}
+export interface UserTastingNotes {
+    source: 'user';
+    inventoryId: number;
+    catalogId: number | null;
+    cupping_notes: string | null;
+    notes: string | null;
+}
+export interface TastingData {
+    beanId: number;
+    filter: TastingFilter;
+    supplier: SupplierTastingNotes | null;
+    user: UserTastingNotes | null;
+}
+export interface CuppingNotes {
+    aroma?: number;
+    body?: number;
+    acidity?: number;
+    sweetness?: number;
+    aftertaste?: number;
+    brew_method?: string;
+    notes?: string;
+    rated_at?: string;
+}
+export declare const tastingFilterSchema: z.ZodEnum<{
+    user: "user";
+    supplier: "supplier";
+    both: "both";
+}>;
+export declare const getTastingNotesSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    filter: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        supplier: "supplier";
+        both: "both";
+    }>>;
+}, z.core.$strip>;
+export type GetTastingNotesInput = z.input<typeof getTastingNotesSchema>;
+export declare const cuppingScoreSchema: z.ZodNumber;
+export declare const rateCoffeeSchema: z.ZodObject<{
+    aroma: z.ZodNumber;
+    body: z.ZodNumber;
+    acidity: z.ZodNumber;
+    sweetness: z.ZodNumber;
+    aftertaste: z.ZodNumber;
+    brewMethod: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RateCoffeeInput = z.input<typeof rateCoffeeSchema>;
+/** Validate a cupping score is an integer in [1, 5]. */
+export declare function isValidCuppingScore(value: number): boolean;
+/** Parse and validate a cupping score flag value (for CLI use). */
+export declare function parseCuppingScore(raw: string, flag: string): number;
+/**
+ * Get tasting notes for a bean by coffee_catalog ID.
+ * Combines supplier notes from coffee_catalog with user notes from green_coffee_inv.
+ */
+export declare function getTastingNotes(supabase: SupabaseClient, userId: string, id: number, filter?: TastingFilter): Promise<TastingData>;
+/**
+ * Rate a coffee by storing cupping scores on the inventory item (must belong to userId).
+ */
+export declare function rateCoffee(supabase: SupabaseClient, userId: string, id: number, input: RateCoffeeInput): Promise<InventoryItem>;
+//# sourceMappingURL=tasting.d.ts.map

package/dist/lib/tasting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasting.d.ts","sourceRoot":"","sources":["../../src/lib/tasting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,mBAAmB;;;;EAAuC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEzE,eAAO,MAAM,kBAAkB,aAAiC,CAAC;AAEjE,eAAO,MAAM,gBAAgB;;;;;;;;iBAQ3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI/D,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASnE;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,aAAsB,GAC7B,OAAO,CAAC,WAAW,CAAC,CA+DtB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,aAAa,CAAC,CA6CxB"}

package/dist/lib/tasting.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { AuthError, PrvrsError } from './errors.js';
+// ─── Zod schemas ──────────────────────────────────────────────────────────────
+export const tastingFilterSchema = z.enum(['user', 'supplier', 'both']);
+export const getTastingNotesSchema = z.object({
+    id: z.number().int().positive(),
+    filter: tastingFilterSchema.default('both'),
+});
+export const cuppingScoreSchema = z.number().int().min(1).max(5);
+export const rateCoffeeSchema = z.object({
+    aroma: cuppingScoreSchema,
+    body: cuppingScoreSchema,
+    acidity: cuppingScoreSchema,
+    sweetness: cuppingScoreSchema,
+    aftertaste: cuppingScoreSchema,
+    brewMethod: z.string().optional(),
+    notes: z.string().optional(),
+});
+// ─── Validation helpers ───────────────────────────────────────────────────────
+/** Validate a cupping score is an integer in [1, 5]. */
+export function isValidCuppingScore(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 5;
+}
+/** Parse and validate a cupping score flag value (for CLI use). */
+export function parseCuppingScore(raw, flag) {
+    const n = parseInt(raw, 10);
+    if (isNaN(n) || !isValidCuppingScore(n)) {
+        throw new PrvrsError('INVALID_ARGUMENT', `--${flag} must be an integer between 1 and 5 (got "${raw}").`);
+    }
+    return n;
+}
+// ─── Pure lib functions ───────────────────────────────────────────────────────
+/**
+ * Get tasting notes for a bean by coffee_catalog ID.
+ * Combines supplier notes from coffee_catalog with user notes from green_coffee_inv.
+ */
+export async function getTastingNotes(supabase, userId, id, filter = 'both') {
+    getTastingNotesSchema.parse({ id, filter });
+    const result = {
+        beanId: id,
+        filter,
+        supplier: null,
+        user: null,
+    };
+    // ── Supplier notes (from coffee_catalog) ─────────────────────────
+    if (filter === 'supplier' || filter === 'both') {
+        const { data: catalogRow, error: catalogError } = await supabase
+            .from('coffee_catalog')
+            .select('id, name, processing, region, source, cupping_notes, ai_tasting_notes, ai_description')
+            .eq('id', id)
+            .single();
+        if (catalogError && catalogError.code !== 'PGRST116') {
+            throw catalogError;
+        }
+        if (catalogRow) {
+            result.supplier = {
+                source: 'supplier',
+                catalogId: catalogRow.id,
+                name: catalogRow.name ?? null,
+                processing: catalogRow.processing ?? null,
+                region: catalogRow.region ?? null,
+                cupping_notes: catalogRow.cupping_notes ?? null,
+                ai_tasting_notes: catalogRow.ai_tasting_notes ?? null,
+                ai_description: catalogRow.ai_description ?? null,
+            };
+        }
+    }
+    // ── User notes (from green_coffee_inv) ───────────────────────────
+    if (filter === 'user' || filter === 'both') {
+        const { data: invRows, error: invError } = await supabase
+            .from('green_coffee_inv')
+            .select('id, catalog_id, cupping_notes, notes')
+            .eq('catalog_id', id)
+            .eq('user', userId)
+            .order('id', { ascending: false })
+            .limit(1);
+        if (invError)
+            throw invError;
+        if (invRows && invRows.length > 0) {
+            const row = invRows[0];
+            result.user = {
+                source: 'user',
+                inventoryId: row.id,
+                catalogId: row.catalog_id ?? null,
+                cupping_notes: row.cupping_notes ?? null,
+                notes: row.notes ?? null,
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Rate a coffee by storing cupping scores on the inventory item (must belong to userId).
+ */
+export async function rateCoffee(supabase, userId, id, input) {
+    const parsed = rateCoffeeSchema.parse(input);
+    // Verify ownership of the inventory item
+    const { data: existing, error: fetchError } = await supabase
+        .from('green_coffee_inv')
+        .select('id, catalog_id')
+        .eq('id', id)
+        .eq('user', userId)
+        .single();
+    if (fetchError || !existing) {
+        throw new AuthError(`Inventory item ${id} not found or does not belong to you.`);
+    }
+    const cupping = {
+        aroma: parsed.aroma,
+        body: parsed.body,
+        acidity: parsed.acidity,
+        sweetness: parsed.sweetness,
+        aftertaste: parsed.aftertaste,
+        rated_at: new Date().toISOString(),
+    };
+    if (parsed.brewMethod !== undefined)
+        cupping.brew_method = parsed.brewMethod;
+    if (parsed.notes !== undefined)
+        cupping.notes = parsed.notes;
+    const { error: updateError } = await supabase
+        .from('green_coffee_inv')
+        .update({ cupping_notes: cupping })
+        .eq('id', id)
+        .eq('user', userId);
+    if (updateError)
+        throw updateError;
+    // Re-fetch the updated row
+    const { data, error } = await supabase
+        .from('green_coffee_inv')
+        .select('id, catalog_id, cupping_notes, notes, last_updated')
+        .eq('id', id)
+        .single();
+    if (error)
+        throw error;
+    return data;
+}
+//# sourceMappingURL=tasting.js.map

package/dist/lib/tasting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasting.js","sourceRoot":"","sources":["../../src/lib/tasting.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,22 @@
 {
   "name": "@purveyors/cli",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "The official CLI for purveyors.io — coffee intelligence from your terminal",
   "type": "module",
   "bin": {
     "purvey": "./dist/index.js"
   },
+  "exports": {
+    ".": "./dist/index.js",
+    "./catalog": "./dist/lib/catalog.js",
+    "./inventory": "./dist/lib/inventory.js",
+    "./roast": "./dist/lib/roast.js",
+    "./sales": "./dist/lib/sales.js",
+    "./tasting": "./dist/lib/tasting.js",
+    "./lib": "./dist/lib/index.js",
+    "./artisan": "./dist/lib/artisan/index.js",
+    "./ai": "./dist/lib/ai.js"
+  },
   "files": [
     "dist",
     "README.md",
@@ -39,10 +50,12 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@clack/prompts": "^1.1.0",
     "@supabase/supabase-js": "^2.49.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
-    "ora": "^8.2.0"
+    "ora": "^8.2.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.0",