@codingfactory/inventory-locator-client 0.1.0

package/src/types/index.ts

@@ -0,0 +1,216 @@
+export interface Location {
+    id: number
+    parent_id: number | null
+    type: LocationType
+    type_label: string
+    name: string
+    code: string
+    full_code: string
+    description: string | null
+    is_active: boolean
+    is_mobile: boolean
+    sort_order: number
+    barcode: string | null
+    metadata: Record<string, unknown> | null
+    children_count?: number
+    product_count?: number
+    children?: Location[]
+    products?: LocationProduct[]
+    path?: PathSegment[]
+    created_at: string
+    updated_at: string
+}
+
+export type LocationType =
+    | 'site' | 'building' | 'container' | 'zone'
+    | 'aisle' | 'rack' | 'shelf' | 'bin' | 'pallet'
+
+export interface PathSegment {
+    id: number
+    name: string
+    code: string
+    full_code: string
+    type: LocationType
+}
+
+export interface LocationProduct {
+    id: number
+    location_id: number
+    product_id: number | string
+    product_type: string
+    product_name: string
+    product_sku: string | null
+    quantity: number
+    is_primary: boolean
+    notes: string | null
+    placed_at: string | null
+    placed_by: number | null
+    location?: Location
+}
+
+export interface Movement {
+    id: number
+    from_location: { id: number; name: string; full_code: string } | null
+    to_location: { id: number; name: string; full_code: string } | null
+    product_id: number | string
+    product_type: string
+    product_name: string
+    quantity: number
+    reason: MovementReason
+    reason_label: string
+    notes: string | null
+    performed_by: number | null
+    performer_name: string | null
+    performed_at: string
+}
+
+export type MovementReason =
+    | 'placed' | 'moved' | 'picked' | 'adjusted'
+    | 'counted' | 'received' | 'returned'
+
+export interface CountSession {
+    id: number
+    name: string
+    scope_location_id: number | null
+    status: CountStatus
+    progress: CountProgress
+    started_at: string | null
+    completed_at: string | null
+    started_by: number | null
+    completed_by: number | null
+    notes: string | null
+    entries_count?: number
+    created_at: string
+    updated_at: string
+}
+
+export type CountStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled'
+
+export interface CountProgress {
+    total: number
+    counted: number
+    verified: number
+    discrepancies: number
+    percent_complete: number
+}
+
+export interface CountEntry {
+    id: number
+    count_session_id: number
+    location_id: number
+    product_id: number | string
+    product_type: string
+    product_name: string
+    expected_quantity: number | null
+    counted_quantity: number | null
+    discrepancy: number | null
+    status: CountEntryStatus
+    counted_by: number | null
+    counted_at: string | null
+    verified_by: number | null
+    verified_at: string | null
+    notes: string | null
+    location?: Location
+}
+
+export type CountEntryStatus = 'pending' | 'counted' | 'verified' | 'adjusted'
+
+export interface LabelData {
+    location: {
+        id: number
+        name: string
+        code: string
+        full_code: string
+        type: LocationType
+        type_label: string
+    }
+    path: string
+    path_segments: PathSegment[]
+    qr_code_svg: string
+    qr_code_url: string
+    barcode_svg: string
+    barcode_value: string
+    format: LabelFormat
+    size: { width: string; height: string }
+}
+
+export type LabelFormat = 'standard' | 'small' | 'pallet'
+
+export interface DashboardStats {
+    total_locations: number
+    locations_by_type: Record<string, number>
+    total_products_tracked: number
+    locations_with_products: number
+    empty_leaf_locations: number
+}
+
+export interface CountReport {
+    session: { id: number; name: string; status: CountStatus }
+    summary: {
+        total_entries: number
+        counted: number
+        verified: number
+        pending: number
+        with_discrepancies: number
+        accuracy_percent: number
+        total_expected: number
+        total_counted: number
+        net_discrepancy: number
+    }
+    top_discrepancies: Array<{
+        location: string
+        product: string
+        expected: number
+        counted: number
+        discrepancy: number
+    }>
+}
+
+export interface CreateLocationData {
+    name: string
+    type: LocationType
+    parent_id?: number | null
+    code?: string | null
+    description?: string | null
+    metadata?: Record<string, unknown> | null
+    sort_order?: number
+}
+
+export interface UpdateLocationData {
+    name?: string
+    code?: string
+    description?: string | null
+    is_active?: boolean
+    metadata?: Record<string, unknown> | null
+    sort_order?: number
+}
+
+export interface PlaceProductData {
+    product_id: number | string
+    product_type?: string
+    quantity?: number
+    is_primary?: boolean
+    notes?: string
+}
+
+export interface MoveProductData {
+    from_location_id: number
+    to_location_id: number
+    quantity?: number
+    notes?: string
+}
+
+export interface LocationTypeInfo {
+    value: LocationType
+    label: string
+    can_contain_products: boolean
+    is_mobile: boolean
+}
+
+export interface Column {
+    key: string
+    label: string
+    sortable?: boolean
+    width?: string
+    align?: 'left' | 'center' | 'right'
+}

package/src/utils/codeFormatter.ts

@@ -0,0 +1,29 @@
+export function splitCode(fullCode: string, separator = '-'): string[] {
+    return fullCode.split(separator)
+}
+
+export function truncateCode(fullCode: string, maxSegments = 2, separator = '-'): string {
+    const parts = fullCode.split(separator)
+    if (parts.length <= maxSegments) return fullCode
+    return '…' + parts.slice(-maxSegments).join(separator)
+}
+
+export function formatQuantity(qty: number): string {
+    if (Number.isInteger(qty)) return String(qty)
+    return qty.toFixed(2).replace(/\.?0+$/, '')
+}
+
+export function timeAgo(dateStr: string): string {
+    const date = new Date(dateStr)
+    const now = new Date()
+    const seconds = Math.floor((now.getTime() - date.getTime()) / 1000)
+
+    if (seconds < 60) return 'just now'
+    const minutes = Math.floor(seconds / 60)
+    if (minutes < 60) return `${minutes}m ago`
+    const hours = Math.floor(minutes / 60)
+    if (hours < 24) return `${hours}h ago`
+    const days = Math.floor(hours / 24)
+    if (days < 7) return `${days}d ago`
+    return date.toLocaleDateString()
+}

package/src/utils/locationIcons.ts

@@ -0,0 +1,64 @@
+import type { LocationType } from '../types'
+
+interface IconDef {
+    viewBox: string
+    path: string
+}
+
+const icons: Record<LocationType, IconDef> = {
+    site: {
+        viewBox: '0 0 24 24',
+        path: 'M12 2C8.13 2 5 5.13 5 9c0 5.25 7 13 7 13s7-7.75 7-13c0-3.87-3.13-7-7-7zm0 9.5a2.5 2.5 0 010-5 2.5 2.5 0 010 5z',
+    },
+    building: {
+        viewBox: '0 0 24 24',
+        path: 'M4 2v20h16V2H4zm4 18H6v-2h2v2zm0-4H6v-2h2v2zm0-4H6V8h2v4zm0-6H6V4h2v2zm4 14h-2v-2h2v2zm0-4h-2v-2h2v2zm0-4h-2V8h2v4zm0-6h-2V4h2v2zm6 14h-4v-4h4v4zm0-6h-2v-2h2v2zm0-4h-2V8h2v4zm0-6h-2V4h2v2z',
+    },
+    container: {
+        viewBox: '0 0 24 24',
+        path: 'M2 4v16h20V4H2zm18 14H4V6h16v12zM6 8h2v8H6V8zm4 0h2v8h-2V8zm4 0h2v8h-2V8z',
+    },
+    zone: {
+        viewBox: '0 0 24 24',
+        path: 'M3 3v18h18V3H3zm16 16H5V5h14v14zM7 7h4v4H7V7zm6 0h4v4h-4V7zm-6 6h4v4H7v-4zm6 0h4v4h-4v-4z',
+    },
+    aisle: {
+        viewBox: '0 0 24 24',
+        path: 'M7 2v20h2V2H7zm8 0v20h2V2h-2zM11 6h2v2h-2V6zm0 4h2v2h-2v-2zm0 4h2v2h-2v-2zm0 4h2v2h-2v-2z',
+    },
+    rack: {
+        viewBox: '0 0 24 24',
+        path: 'M3 2v20h2v-7h14v7h2V2H3zm16 4H5V4h14v2zm0 5H5V9h14v2z',
+    },
+    shelf: {
+        viewBox: '0 0 24 24',
+        path: 'M3 10h18v2H3v-2zm0-4h18v2H3V6zm2 8h4v6H5v-6zm6 0h4v6h-4v-6zm6 0h4v6h-4v-6z',
+    },
+    bin: {
+        viewBox: '0 0 24 24',
+        path: 'M5 4v16h14V4H5zm12 14H7V8h10v10zm-8-8h2v2H9V10zm4 0h2v2h-2v-2z',
+    },
+    pallet: {
+        viewBox: '0 0 24 24',
+        path: 'M2 18h2v2H2v-2zm4 0h2v2H6v-2zm4 0h2v2h-2v-2zm4 0h2v2h-2v-2zm4 0h2v2h-2v-2zM2 14h20v2H2v-2zm1-4h4v3H3v-3zm7 0h4v3h-4v-3zm7 0h4v3h-4v-3z',
+    },
+}
+
+export function getLocationIcon(type: LocationType): IconDef {
+    return icons[type] || icons.building
+}
+
+export function getLocationTypeLabel(type: LocationType): string {
+    const labels: Record<LocationType, string> = {
+        site: 'Site',
+        building: 'Building',
+        container: 'Shipping Container',
+        zone: 'Zone',
+        aisle: 'Aisle',
+        rack: 'Rack',
+        shelf: 'Shelf',
+        bin: 'Bin',
+        pallet: 'Pallet',
+    }
+    return labels[type] || type
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "strict": true,
+        "jsx": "preserve",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "outDir": "dist",
+        "baseUrl": ".",
+        "paths": {
+            "@/*": ["src/*"]
+        },
+        "types": ["vite/client"],
+        "lib": ["ES2022", "DOM", "DOM.Iterable"]
+    },
+    "include": ["src/**/*.ts", "src/**/*.vue"],
+    "exclude": ["node_modules", "dist", "tests"]
+}

package/vite.config.ts

@@ -0,0 +1,37 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import dts from 'vite-plugin-dts'
+import { resolve } from 'path'
+
+export default defineConfig({
+    plugins: [
+        vue(),
+        dts({ rollupTypes: true }),
+    ],
+    build: {
+        lib: {
+            entry: resolve(__dirname, 'src/index.ts'),
+            name: 'InventoryLocatorClient',
+            formats: ['es', 'cjs'],
+            fileName: (format) => `index.${format === 'es' ? 'js' : 'cjs'}`,
+        },
+        rollupOptions: {
+            external: ['axios', 'pinia', 'vue', 'vue-router'],
+            output: {
+                globals: {
+                    vue: 'Vue',
+                    pinia: 'Pinia',
+                    axios: 'axios',
+                    'vue-router': 'VueRouter',
+                },
+                assetFileNames: 'inventory-locator-client.[ext]',
+            },
+        },
+        cssCodeSplit: false,
+    },
+    resolve: {
+        alias: {
+            '@': resolve(__dirname, 'src'),
+        },
+    },
+})