---
description: 
globs: 
alwaysApply: false
---
# Splitting Namespace Functions into Scopes

This rule defines how to organize functionality in a namespace by scope.

## Structure

1. Split functionality into three scopes:
   - `customer` - Functions related to customer operations
   - `store` - Functions related to store operations  
   - `admin` - Functions related to admin operations

2. Create separate files for each scope:
   - `customer.functions.ts` - Customer-related functions
   - `store.functions.ts` - Store-related functions
   - `admin.functions.ts` - Admin-related functions

3. Create a main functions file (e.g., `functions.ts`) that:
   - Imports all scope files
   - Exports a context mapping function (`contextTo<namespace>FunctionMapping`)

## Implementation Rules

1. **No cross-imports**: Do not import between scope files (customer/store/admin)
2. **Context mapping**: Create a mapping function that determines which function to use based on context parameters
3. **Exports**: Export all functions through the main functions file

## Example (Order namespace)

In `functions.ts`:
```typescript
import * as customer from './customer.functions';
import * as admin from './admin.functions';
import * as store from './store.functions';

export const contextToOrderFunctionMapping = ({
  customerId,
  storeKey,
}: {
  customerId?: string;
  storeKey?: string;
}): Record<string, Function> => {
  if (customerId) {
    return {
      read_order: customer.readCustomerOrder,
    };
  }
  if (storeKey) {
    return {
      read_order: store.readStoreOrder,
      create_order_from_cart: store.createOrderFromCartInStore,
      create_order_from_quote: store.createOrderFromQuoteInStore,
      update_order: store.updateOrderByIdInStore,
    };
  }
  return {
    read_order: admin.readOrder,
    create_order_from_cart: admin.createOrderFromCart,
    create_order_from_quote: admin.createOrderFromQuote,
    create_order_by_import: admin.createOrderByImport,
    update_order: admin.updateOrder,
  };
};
```