@tailor-platform/erp-kit 0.1.2 → 0.2.1

package/skills/app-compose-5-design-mock-review/references/screen-listview.md

@@ -1,153 +0,0 @@
-# ListView Screen Implementation
-
-Implementation pattern for screens with `Screen Type: ListView`.
-Assumes `page.md` and `component.md` rules.
-
-## File Structure
-
-```
-{screen-path}/
-├── components/
-│   └── {screen-name}-table.tsx     # Table component with fragments
-└── page.tsx
-```
-
-## Page Component (page.tsx)
-
-Data fetching and `Layout` must be co-located in the same page component.
-Do NOT split into an inner Content component — `Layout` requires `Layout.Column` as direct children.
-
-```tsx
-const ResourcesQuery = graphql(
-  `
-    query Resources {
-      resources {
-        ...ResourceTable
-      }
-    }
-  `,
-  [ResourceTableFragment],
-);
-
-const ResourcesPage = () => {
-  const [{ data, error, fetching }, reexecuteQuery] = useQuery({
-    query: ResourcesQuery,
-  });
-
-  if (fetching) return <Loading />;
-
-  if (error || !data) {
-    return (
-      <ErrorFallback
-        title="Failed to load resources"
-        message="An error occurred while fetching the list."
-        onReset={() => reexecuteQuery({ requestPolicy: "network-only" })}
-      />
-    );
-  }
-
-  return (
-    <Layout
-      columns={1}
-      title="Resources"
-      actions={[
-        <Button key="create" asChild>
-          <Link to="create">Create</Link>
-        </Button>,
-      ]}
-    >
-      <Layout.Column>
-        <ResourceTable data={data.resources} />
-      </Layout.Column>
-    </Layout>
-  );
-};
-```
-
-## Table Component (components/{screen-name}-table.tsx)
-
-### Fragment Collocation
-
-Define a row fragment and a table fragment wrapping the Connection type.
-
-```tsx
-const ResourceRowFragment = graphql(`
-  fragment ResourceRow on Resource {
-    id
-    title
-    status
-    createdAt
-  }
-`);
-
-export const ResourceTableFragment = graphql(
-  `
-    fragment ResourceTable on ResourceConnection {
-      edges {
-        node {
-          ...ResourceRow
-        }
-      }
-    }
-  `,
-  [ResourceRowFragment],
-);
-```
-
-### Row Component
-
-```tsx
-const ResourceRow = ({ resource: resourceFragment }: ResourceRowProps) => {
-  const resource = readFragment(ResourceRowFragment, resourceFragment);
-  return (
-    <TableRow>
-      <TableCell>{resource.title}</TableCell>
-      <TableCell>
-        <Badge variant={resource.status === "ACTIVE" ? "default" : "secondary"}>
-          {resource.status}
-        </Badge>
-      </TableCell>
-      <TableCell>
-        <Button variant="ghost" size="sm" asChild>
-          <Link to={resource.id}>View</Link>
-        </Button>
-      </TableCell>
-    </TableRow>
-  );
-};
-```
-
-### Empty State
-
-```tsx
-if (connection.edges.length === 0) {
-  return (
-    <EmptyState
-      title="No resources"
-      message="Get started by creating a new resource."
-      action={
-        <Button asChild>
-          <Link to="create">Create</Link>
-        </Button>
-      }
-    />
-  );
-}
-```
-
-## Column Property Mapping
-
-| Property        | Implementation                                              |
-| --------------- | ----------------------------------------------------------- |
-| Hideable: Yes   | Column visibility state to toggle show/hide                 |
-| Sortable: Yes   | Sort icon on `<TableHead>` + onClick to toggle query vars   |
-| Filterable: Yes | Filter UI above table (`<Select />`)                        |
-| Searchable: Yes | Search input above table (`<Input placeholder="Search" />`) |
-
-## Key Points
-
-- Use `<Badge />` for status columns
-- Format dates with `toLocaleDateString()`
-- Use `<EmptyState />` with Create action for empty lists
-- Add a View button per row to navigate to the detail page
-- Iterate data using Connection type `edges.node` pattern

package/skills/app-compose-6-implementation-spec/references/auth.md

@@ -1,72 +0,0 @@
-# Backend Auth Configuration
-
-Use Tailor SDK auth resources as the default pattern for backend authentication setup.
-
-## Standard Auth Shape
-
-In `tailor.config.ts`:
-
-- Define IdP with `defineIdp(...)`
-- Define Auth with `defineAuth(...)`
-- Define static website with `defineStaticWebSite(...)` when frontend is deployed as static hosting
-- Wire `idProvider` via `idp.provider(...)`
-- Set exactly one OAuth2 client for frontend login (default client name: `default`)
-- Export config with `auth: auth` and `idp: [idp]`
-- Include static website URL in CORS when using deployed frontend (for example, `cors: ["http://localhost:5173", website.url]`)
-
-Prefer this stable naming unless there is a clear reason to change:
-
-- Auth name: `default`
-- IdP name: `default`
-- OAuth2 client name: `default`
-
-## User Mapping
-
-Use `userProfile` to map authenticated identities to the application user type.
-
-- `type`: module-provided user type
-- `usernameField`: stable unique field (for example, `email`)
-- `attributes`: explicitly list required attributes
-
-Avoid implicit attribute assumptions.
-
-## CORS for Static Website Login
-
-When frontend is deployed via `staticWebsites`, OAuth metadata and query calls are cross-origin from `https://<name>-<workspace>.web.erp.dev` to app backend.
-
-- Always include the deployed static website origin via `website.url` in backend `cors`
-- Keep local development origin in `cors` as well (for example, `http://localhost:5173`)
-- If your template uses IP allow lists, set `allowedIpAddresses` appropriately for Tailor internal access
-
-If `website.url` is missing from `cors`, login may fail with browser CORS errors before authentication starts.
-
-## Seed Permission Alignment
-
-Seeded login users in `seed/data/User.jsonl` must receive module permissions required by guarded commands/resolvers.
-
-- Do not assume `ADMIN` is automatically privileged unless your permission evaluator explicitly supports it
-- Grant concrete permission keys defined by the module (for example, `user-management:createUser`)
-- Keep `User.jsonl` permissions aligned with the module currently wired in `src/modules.ts`
-
-## Workspace and CLI Inputs
-
-Use `TAILOR_PLATFORM_WORKSPACE_ID` in backend `.env` for CLI operations.
-
-Required for non-interactive resource lookup and automation:
-
-- `tailor-sdk oauth2client list`
-- `tailor-sdk oauth2client get <name>`
-
-Use `--env-file <backend/.env>` for deterministic command execution in local/dev scripts.
-
-## OAuth Client ID Source of Truth
-
-Frontend `VITE_TAILOR_CLIENT_ID` must come from backend-managed OAuth2 client data.
-
-Canonical retrieval flow:
-
-1. `tailor-sdk oauth2client get default --json`
-2. Copy `clientId` from command output
-3. Set it in frontend env
-
-Do not hardcode OAuth client IDs in source code.

package/skills/app-compose-6-implementation-spec/references/structure.md

@@ -1,27 +0,0 @@
-# Application Directory Structure
-
-```
-{app_name}/
-├── backend/
-│   ├── src/
-│   │   ├── modules.ts              # Declaring module usage
-│   │   ├── modules/
-│   │   │   └── {module-name}/      # Module-specific directory
-│   │   │       ├── resolvers/      # API Definition to expose graphql apis
-│   │   │       └── executors/      # PubSub Automation (one file per declaration)
-│   │   └── generated/              # Auto-generated code (do not edit)
-│   └── tailor.config.ts            # tailor application config
-│
-└── frontend/
-    └── src/
-        ├── pages/                  # File-based routing (auto-discovered by Vite plugin)
-        │   └── {page-path}/
-        │       ├── page.tsx
-        │       └── {page-path}/
-        │           ├── components/
-        │           └── page.tsx
-        ├── components/
-        │   └── ui/                 # Generic UI components
-        ├── graphql/                # gql.tada settings
-        └── providers/              # react providers
-```

package/src/modules/primitives/lib/errors.ts

@@ -1,138 +0,0 @@
-import { createDomainError } from "../../shared/internal";
-
-export const UoMCategoryNotFoundError = createDomainError(
-  "UoMCategoryNotFoundError",
-  "UOM_CATEGORY_NOT_FOUND",
-  (identifier: string) => `UoM category not found: ${identifier}`,
-);
-
-export const UnitNotFoundError = createDomainError(
-  "UnitNotFoundError",
-  "UNIT_NOT_FOUND",
-  (symbol: string) => `Unit not found: ${symbol}`,
-);
-
-export const IncompatibleUnitsError = createDomainError(
-  "IncompatibleUnitsError",
-  "INCOMPATIBLE_UNITS",
-  (sourceSymbol: string, targetSymbol: string) =>
-    `Cannot convert between incompatible units: ${sourceSymbol} and ${targetSymbol} belong to different categories`,
-);
-
-export const InactiveUnitError = createDomainError(
-  "InactiveUnitError",
-  "INACTIVE_UNIT",
-  (symbol: string) => `Unit is inactive: ${symbol}`,
-);
-
-export const CurrencyNotFoundError = createDomainError(
-  "CurrencyNotFoundError",
-  "CURRENCY_NOT_FOUND",
-  (code: string) => `Currency not found: ${code}`,
-);
-
-export const InactiveCurrencyError = createDomainError(
-  "InactiveCurrencyError",
-  "INACTIVE_CURRENCY",
-  (code: string) => `Currency is inactive: ${code}`,
-);
-
-export const ExchangeRateNotFoundError = createDomainError(
-  "ExchangeRateNotFoundError",
-  "EXCHANGE_RATE_NOT_FOUND",
-  (sourceCode: string, targetCode: string, date: string) =>
-    `No exchange rate found for ${sourceCode} to ${targetCode} on or before ${date}`,
-);
-
-export const CannotDeactivateReferenceUnitError = createDomainError(
-  "CannotDeactivateReferenceUnitError",
-  "CANNOT_DEACTIVATE_REFERENCE_UNIT",
-  (unitId: string) => `Cannot deactivate reference unit: ${unitId}. Change reference unit first.`,
-);
-
-export const CategoryNotActiveError = createDomainError(
-  "CategoryNotActiveError",
-  "CATEGORY_NOT_ACTIVE",
-  (categoryId: string) => `Category is not active: ${categoryId}`,
-);
-
-export const DuplicateUnitSymbolError = createDomainError(
-  "DuplicateUnitSymbolError",
-  "DUPLICATE_UNIT_SYMBOL",
-  (symbol: string, categoryId: string) =>
-    `Unit with symbol "${symbol}" already exists in category ${categoryId}`,
-);
-
-export const InvalidConversionFactorError = createDomainError(
-  "InvalidConversionFactorError",
-  "INVALID_CONVERSION_FACTOR",
-  (factor: number) => `Conversion factor must be positive: ${factor}`,
-);
-
-export const InvalidRoundingPrecisionError = createDomainError(
-  "InvalidRoundingPrecisionError",
-  "INVALID_ROUNDING_PRECISION",
-  (precision: number) => `Rounding precision must be non-negative: ${precision}`,
-);
-
-export const DuplicateCategoryNameError = createDomainError(
-  "DuplicateCategoryNameError",
-  "DUPLICATE_CATEGORY_NAME",
-  (name: string) => `Category with name "${name}" already exists`,
-);
-
-export const CategoryHasActiveUnitsError = createDomainError(
-  "CategoryHasActiveUnitsError",
-  "CATEGORY_HAS_ACTIVE_UNITS",
-  (categoryId: string) => `Cannot deactivate category ${categoryId}: has active units`,
-);
-
-export const UnitNotInCategoryError = createDomainError(
-  "UnitNotInCategoryError",
-  "UNIT_NOT_IN_CATEGORY",
-  (unitId: string, categoryId: string) =>
-    `Unit ${unitId} does not belong to category ${categoryId}`,
-);
-
-export const InvalidISOCodeError = createDomainError(
-  "InvalidISOCodeError",
-  "INVALID_ISO_CODE",
-  (code: string) => `Invalid ISO 4217 code: "${code}". Must be exactly 3 uppercase letters.`,
-);
-
-export const DuplicateCurrencyCodeError = createDomainError(
-  "DuplicateCurrencyCodeError",
-  "DUPLICATE_CURRENCY_CODE",
-  (code: string) => `Currency with code "${code}" already exists`,
-);
-
-export const InvalidDecimalPlacesError = createDomainError(
-  "InvalidDecimalPlacesError",
-  "INVALID_DECIMAL_PLACES",
-  (decimalPlaces: number) => `Decimal places must be between 0 and 4: ${decimalPlaces}`,
-);
-
-export const CannotDeactivateBaseCurrencyError = createDomainError(
-  "CannotDeactivateBaseCurrencyError",
-  "CANNOT_DEACTIVATE_BASE_CURRENCY",
-  (currencyId: string) =>
-    `Cannot deactivate base currency: ${currencyId}. Change base currency first.`,
-);
-
-export const CannotSetInactiveAsBaseCurrencyError = createDomainError(
-  "CannotSetInactiveAsBaseCurrencyError",
-  "CANNOT_SET_INACTIVE_AS_BASE_CURRENCY",
-  (currencyId: string) => `Cannot set inactive currency as base: ${currencyId}. Activate it first.`,
-);
-
-export const SameCurrencyPairError = createDomainError(
-  "SameCurrencyPairError",
-  "SAME_CURRENCY_PAIR",
-  (currencyId: string) => `Source and target currency cannot be the same: ${currencyId}`,
-);
-
-export const InvalidExchangeRateError = createDomainError(
-  "InvalidExchangeRateError",
-  "INVALID_EXCHANGE_RATE",
-  (rate: number) => `Exchange rate must be positive: ${rate}`,
-);

package/src/modules/user-management/lib/errors.ts

@@ -1,81 +0,0 @@
-import { createDomainError } from "../../shared/internal";
-
-export const UserNotFoundError = createDomainError(
-  "UserNotFoundError",
-  "USER_NOT_FOUND",
-  (userId: string) => `User not found: ${userId}`,
-);
-
-export const UserAlreadyExistsError = createDomainError(
-  "UserAlreadyExistsError",
-  "USER_ALREADY_EXISTS",
-  (email: string) => `User with email "${email}" already exists`,
-);
-
-export const UserNotActiveError = createDomainError(
-  "UserNotActiveError",
-  "USER_NOT_ACTIVE",
-  (userId: string, status: string) => `User ${userId} is not active (current status: ${status})`,
-);
-
-export const InvalidEmailError = createDomainError(
-  "InvalidEmailError",
-  "INVALID_EMAIL",
-  (email: string) => `Invalid email format: ${email}`,
-);
-
-export const MissingRequiredFieldError = createDomainError(
-  "MissingRequiredFieldError",
-  "MISSING_REQUIRED_FIELD",
-  (field: string) => `Missing required field: ${field}`,
-);
-
-export const InvalidStatusTransitionError = createDomainError(
-  "InvalidStatusTransitionError",
-  "INVALID_STATUS_TRANSITION",
-  (currentStatus: string, targetStatus: string) =>
-    `Invalid status transition from ${currentStatus} to ${targetStatus}`,
-);
-
-export const PermissionNotFoundError = createDomainError(
-  "PermissionNotFoundError",
-  "PERMISSION_NOT_FOUND",
-  (permissionId: string) => `Permission not found: ${permissionId}`,
-);
-
-export const DuplicatePermissionKeyError = createDomainError(
-  "DuplicatePermissionKeyError",
-  "DUPLICATE_PERMISSION_KEY",
-  (key: string) => `Permission with key "${key}" already exists`,
-);
-
-export const InvalidPermissionKeyFormatError = createDomainError(
-  "InvalidPermissionKeyFormatError",
-  "INVALID_PERMISSION_KEY_FORMAT",
-  (key: string) => `Invalid permission key format: "${key}". Expected format: resource:action`,
-);
-
-export const RoleNotFoundError = createDomainError(
-  "RoleNotFoundError",
-  "ROLE_NOT_FOUND",
-  (roleId: string) => `Role not found: ${roleId}`,
-);
-
-export const DuplicateRoleNameError = createDomainError(
-  "DuplicateRoleNameError",
-  "DUPLICATE_ROLE_NAME",
-  (name: string) => `Role with name "${name}" already exists`,
-);
-
-export const AssignmentNotFoundError = createDomainError(
-  "AssignmentNotFoundError",
-  "ASSIGNMENT_NOT_FOUND",
-  (sourceType: string, sourceId: string, targetType: string, targetId: string) =>
-    `Assignment not found: ${sourceType} ${sourceId} -> ${targetType} ${targetId}`,
-);
-
-export const InvalidEventTypeError = createDomainError(
-  "InvalidEventTypeError",
-  "INVALID_EVENT_TYPE",
-  (eventType: string) => `Invalid event type: ${eventType}`,
-);