@fayz-ai/saas 0.1.6

package/src/shell/types/billing.ts

@@ -0,0 +1,90 @@
+export type PlanInterval = 'monthly' | 'yearly'
+export type SubscriptionStatus = 'active' | 'trialing' | 'past_due' | 'canceled' | 'paused'
+
+export interface Plan {
+  id: string
+  verticalId?: string
+  name: string
+  description?: string
+  tier: number
+  priceMonthly: number
+  priceYearly: number
+  currency: string
+  features: string[]
+  limits: Record<string, number>
+  isActive: boolean
+  createdAt: string
+  /** @deprecated Use priceMonthly/priceYearly */
+  prices?: { monthly: number; yearly: number }
+  popular?: boolean
+}
+
+/**
+ * Config-friendly plan shape for createSaasApp({ billing: { plans } }).
+ * Infrastructure fields (tier, currency, isActive, createdAt, limits) are
+ * optional and filled in by normalizePlanConfig.
+ */
+export interface PlanConfig {
+  id: string
+  name: string
+  description?: string
+  features: string[]
+  prices?: { monthly: number; yearly: number }
+  priceMonthly?: number
+  priceYearly?: number
+  tier?: number
+  currency?: string
+  limits?: Record<string, number>
+  popular?: boolean
+  verticalId?: string
+}
+
+export function normalizePlanConfig(plan: PlanConfig, index?: number): Plan {
+  return {
+    id: plan.id,
+    verticalId: plan.verticalId,
+    name: plan.name,
+    description: plan.description,
+    tier: plan.tier ?? (index !== undefined ? index + 1 : 1),
+    priceMonthly: plan.priceMonthly ?? plan.prices?.monthly ?? 0,
+    priceYearly: plan.priceYearly ?? plan.prices?.yearly ?? 0,
+    currency: plan.currency ?? 'USD',
+    features: plan.features,
+    limits: plan.limits ?? {},
+    isActive: true,
+    createdAt: new Date().toISOString(),
+    prices: plan.prices,
+    popular: plan.popular,
+  }
+}
+
+export interface Subscription {
+  id: string
+  tenantId: string
+  planId: string
+  status: SubscriptionStatus
+  interval: PlanInterval
+  currentPeriodStart: string
+  currentPeriodEnd: string
+  cancelAtPeriodEnd: boolean
+  trialEnd?: string
+  stripeSubscriptionId?: string
+}
+
+export interface Invoice {
+  id: string
+  tenantId: string
+  amount: number
+  currency: string
+  status: 'draft' | 'open' | 'paid' | 'void' | 'uncollectible'
+  pdfUrl?: string
+  createdAt: string
+  paidAt?: string
+}
+
+export interface BillingState {
+  subscription: Subscription | null
+  invoices: Invoice[]
+  plans: Plan[]
+  loading: boolean
+}

package/src/shell/types/client-orders.ts

@@ -0,0 +1,58 @@
+// ---------------------------------------------------------------------------
+// Client Orders / Documents — Unified stage-based types for the "Pedidos" tab
+// One row per commercial interaction, progressing through stages.
+// ---------------------------------------------------------------------------
+
+/** Order lifecycle stage */
+export type ClientDocumentStage =
+  | 'draft'
+  | 'quoted'
+  | 'booked'
+  | 'invoiced'
+  | 'paid'
+  | 'partial'
+  | 'overdue'
+  | 'cancelled'
+  | 'no_show'
+  | 'completed'
+
+/** A unified row in the client orders list */
+export interface ClientDocument {
+  id: string
+  /** What it is: appointment, sale, purchase */
+  kind: string
+  /** Where it is in lifecycle */
+  stage: ClientDocumentStage
+  /** Sequential reference number, e.g. #REC-00001 */
+  referenceNumber?: string
+  /** Primary date — starts_at for booked orders, created_at otherwise */
+  date: string
+  /** Booking start time (only for orders with starts_at) */
+  startsAt?: string
+  /** Total amount */
+  total: number
+  /** Amount paid so far */
+  paidAmount?: number
+  /** Human-readable description — service names, item summary, etc. */
+  description?: string
+  createdAt: string
+}
+
+/** Query parameters for fetching client documents */
+export interface ClientOrdersQuery {
+  clientId: string
+  /** Filter by stage group: 'quoted', 'booked', 'invoiced', 'paid' */
+  stages?: string[]
+  page?: number
+  pageSize?: number
+}
+
+/** Provider interface for fetching a client's unified order/document list */
+export interface ClientOrdersProvider {
+  getDocuments(query: ClientOrdersQuery): Promise<{ data: ClientDocument[]; total: number }>
+}
+
+/** Navigator callback for clicking a row in the orders tab */
+export interface ClientOrdersNavigator {
+  onNavigate(doc: ClientDocument): void
+}

package/src/shell/types/crud.ts

@@ -0,0 +1,134 @@
+import type React from 'react'
+import type { EntityArchetype } from './entities'
+
+export type FieldType =
+  | 'text' | 'email' | 'phone' | 'url' | 'image'
+  | 'number' | 'currency'
+  | 'select' | 'multiselect' | 'segmented'
+  | 'date' | 'datetime' | 'time'
+  | 'boolean' | 'textarea'
+  | 'color' | 'computed'
+
+/** Read-only display produced by a `computed` field's `compute()`. */
+export interface ComputedFieldValue {
+  display: string
+  tone?: 'positive' | 'negative' | 'neutral'
+}
+
+export interface FieldDef {
+  key: string
+  label: string
+  type: FieldType
+  required?: boolean
+  placeholder?: string
+  /** Small helper text shown under the field input. */
+  hint?: string
+  options?: string[] | { label: string; value: string; description?: string }[]
+  min?: number
+  max?: number
+  currency?: string
+  /** Symbol/locale for the `currency` field's CurrencyInput. Default 'R$' / 'pt-BR'. */
+  currencySymbol?: string
+  currencyLocale?: string
+  showInTable?: boolean
+  showInForm?: boolean
+  /** Show this field in the detail page overview (default: true) */
+  showInDetail?: boolean
+  sortable?: boolean
+  searchable?: boolean
+  renderCell?: (value: any, row: any) => React.ReactNode
+  /** Derives a read-only value from the other form values (for `computed` fields). */
+  compute?: (values: Record<string, any>) => ComputedFieldValue | null
+  defaultValue?: any
+  /** Field group name — groups fields into sections in forms and detail views */
+  group?: string
+  /** Column span in two-column layout: 1 (half) or 2 (full width). Default: 1 */
+  span?: 1 | 2
+  /** For boolean fields: render as inline toggle in the table, allowing direct toggling without editing */
+  inlineToggle?: boolean
+}
+
+export interface FieldGroup {
+  id: string
+  label: string
+  description?: string
+  /** Number of columns for this group (default: 2) */
+  columns?: 1 | 2 | 3
+  /** Renders a decorative image slot to the left of the group's fields. */
+  imageSlot?: boolean
+}
+
+export interface DetailTab {
+  id: string
+  label: string
+  icon?: string
+  /** React component to render as tab content. Receives { item, entityDef, ...props } —
+   * extra required props can be supplied via the `props` field below. */
+  component?: React.ComponentType<any>
+  /** Restrict tab visibility to specific archetypeKind values. If omitted, tab shows for all. */
+  visibleFor?: string[]
+  /** Extra props passed through to the tab component */
+  props?: Record<string, unknown>
+}
+
+export type FormLayout = 'person' | 'product' | 'service' | 'location' | 'order' | 'subject' | 'generic'
+
+export interface EntityDef<T = Record<string, any>> {
+  name: string
+  namePlural?: string
+  icon: string
+  /** Form/detail layout preset. Determines the archetype-specific form layout. */
+  layout?: FormLayout
+  fields: FieldDef[]
+  /** Named groups for organizing fields in forms and detail views */
+  fieldGroups?: FieldGroup[]
+  /** Custom tabs on the detail page (in addition to Overview) */
+  detailTabs?: DetailTab[]
+  data?: {
+    table: string
+    schema?: string
+    tenantScoped?: boolean
+    tenantIdColumn?: string
+    searchColumns?: string[]
+    selectColumns?: string
+    columnMap?: Record<string, string>
+    /** Which saas_core archetype this entity extends (requires a project extension table) */
+    archetype?: EntityArchetype
+    /** The `kind` discriminator value for the archetype table */
+    archetypeKind?: string
+    /** Static filters applied to all queries (e.g. { kind: 'supplier' }) */
+    filters?: Record<string, string>
+    /** Default values merged into every create payload */
+    defaults?: Record<string, unknown>
+    /** Cache TTL in ms for list queries (default: 60 000 — 1 minute) */
+    cacheTTL?: number
+  }
+  defaultSort?: string
+  defaultSortDir?: 'asc' | 'desc'
+  displayField?: string
+  /** Secondary field shown below the display field in detail hero (e.g., email) */
+  subtitleField?: string
+  /** Field key containing an image URL — shown as hero image on card layout and detail avatar */
+  imageField?: string
+  /** Faceted filters shown as pills below the list search box. Each references a
+   *  field whose `options` supply the pills; an "All" pill clears the filter. */
+  facets?: { field: string; allLabel?: string }[]
+}
+
+// ---------------------------------------------------------------------------
+// Tenant-level field rule overrides
+// ---------------------------------------------------------------------------
+
+/** Per-field override configured by tenant admin */
+export interface FieldRuleOverride {
+  required?: boolean
+  showInForm?: boolean
+  showInTable?: boolean
+  showInDetail?: boolean
+}
+
+/** Field overrides for a single register type, keyed by field.key */
+export type EntityFieldRules = Record<string, FieldRuleOverride>
+
+/** All field rules for a tenant, keyed by entityKey (e.g. "person:client", "product") */
+export type TenantFieldRules = Record<string, EntityFieldRules>

package/src/shell/types/entities.ts

@@ -0,0 +1,169 @@
+export type EntityArchetype = 'person' | 'category' | 'product' | 'service' | 'order' | 'transaction' | 'schedule' | 'location'
+
+export interface BaseEntity {
+  id: string
+  tenantId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface PersonEntity extends BaseEntity {
+  archetype: 'person'
+  kind: string
+  name: string
+  email?: string
+  phone?: string
+  documentNumber?: string
+  avatarUrl?: string
+  dateOfBirth?: string
+  address?: string
+  city?: string
+  state?: string
+  country: string
+  postalCode?: string
+  tags: string[]
+  isActive: boolean
+  notes?: string
+  metadata: Record<string, unknown>
+}
+
+export interface CategoryEntity extends BaseEntity {
+  archetype: 'category'
+  kind: string
+  name: string
+  slug?: string
+  parentId?: string
+  icon?: string
+  color?: string
+  sortOrder: number
+  isActive: boolean
+  metadata: Record<string, unknown>
+}
+
+export interface ProductEntity extends BaseEntity {
+  archetype: 'product'
+  categoryId?: string
+  name: string
+  description?: string
+  sku?: string
+  price?: number
+  cost?: number
+  currency: string
+  unit?: string
+  imageUrl?: string
+  stock?: number
+  minStock?: number
+  status: string
+  isActive: boolean
+  tags: string[]
+  metadata: Record<string, unknown>
+}
+
+export interface ServiceEntity extends BaseEntity {
+  archetype: 'service'
+  categoryId?: string
+  name: string
+  description?: string
+  price?: number
+  cost?: number
+  currency: string
+  durationMinutes?: number
+  imageUrl?: string
+  status: string
+  isActive: boolean
+  tags: string[]
+  metadata: Record<string, unknown>
+}
+
+export interface OrderEntity extends BaseEntity {
+  archetype: 'order'
+  kind: string
+  referenceNumber?: string
+  status: string
+  partyId?: string
+  assigneeId?: string
+  locationId?: string
+  subtotal: number
+  discount: number
+  tax: number
+  total: number
+  currency: string
+  dueAt?: string
+  completedAt?: string
+  notes?: string
+  tags: string[]
+  metadata: Record<string, unknown>
+}
+
+export interface OrderItemEntity {
+  id: string
+  orderId: string
+  productId?: string
+  serviceId?: string
+  name: string
+  description?: string
+  quantity: number
+  unitPrice: number
+  discount: number
+  total: number
+  sortOrder: number
+  metadata: Record<string, unknown>
+  createdAt: string
+}
+
+export interface TransactionEntity extends BaseEntity {
+  archetype: 'transaction'
+  kind: string
+  orderId?: string
+  partyId?: string
+  amount: number
+  currency: string
+  paymentMethod?: string
+  reference?: string
+  status: string
+  transactedAt: string
+  notes?: string
+  metadata: Record<string, unknown>
+}
+
+
+export interface LocationEntity extends BaseEntity {
+  archetype: 'location'
+  kind: string
+  name: string
+  email?: string
+  phone?: string
+  address?: string
+  city?: string
+  state?: string
+  country: string
+  postalCode?: string
+  isHeadquarters: boolean
+  isActive: boolean
+  tags: string[]
+  notes?: string
+  metadata: Record<string, unknown>
+}
+
+export interface ScheduleEntity extends BaseEntity {
+  archetype: 'schedule'
+  kind: string
+  assigneeId?: string
+  locationId?: string
+  dayOfWeek?: number
+  specificDate?: string
+  startsAt: string
+  endsAt: string
+  isActive: boolean
+  metadata: Record<string, unknown>
+}
+
+export type Entity =
+  | PersonEntity
+  | CategoryEntity
+  | ProductEntity
+  | ServiceEntity
+  | LocationEntity
+  | OrderEntity
+  | TransactionEntity
+  | ScheduleEntity

package/src/shell/types/entity-lookup.ts

@@ -0,0 +1,25 @@
+// ---------------------------------------------------------------------------
+// Entity Lookup — cross-plugin entity reference types
+// Pure types only. Runtime functions are in lib/archetype-lookup.ts
+// ---------------------------------------------------------------------------
+
+export interface EntityLookupResult {
+  id: string
+  label: string
+  subtitle?: string
+  group?: string
+  icon?: string
+  price?: number
+  data?: Record<string, unknown>
+}
+
+export interface EntityLookup {
+  search(query: string): Promise<EntityLookupResult[]>
+  getById(id: string): Promise<EntityLookupResult | null>
+  /** Return initial items without a search filter (e.g. first N alphabetically) */
+  list?(): Promise<EntityLookupResult[]>
+}
+
+export type EntityLookupMap = Record<string, EntityLookup>
+
+export type ArchetypeType = 'person' | 'product' | 'service' | 'location'

package/src/shell/types/index.ts

@@ -0,0 +1,16 @@
+export * from './auth'
+export * from './auth-adapter'
+export * from './tenant'
+export * from './layout'
+export * from './billing'
+export * from './notifications'
+export * from './plugins'
+export * from './entities'
+export * from './integrations'
+export * from './crud'
+export * from './permissions'
+export * from './invite'
+export * from './org-adapter'
+export * from './platform'
+export * from './entity-lookup'
+export * from './client-orders'

package/src/shell/types/integrations.ts

@@ -0,0 +1,51 @@
+export type IntegrationCategory = 'calendar' | 'email' | 'messaging' | 'payment' | 'storage'
+export type IntegrationAuthType = 'oauth2' | 'api_key' | 'webhook' | 'none'
+
+export interface IntegrationProvider {
+  id: string
+  name: string
+  description?: string
+  category: IntegrationCategory
+  authType: IntegrationAuthType
+  configSchema: Record<string, unknown>
+  icon?: string
+  isActive: boolean
+  createdAt: string
+}
+
+export interface TenantIntegration {
+  id: string
+  tenantId: string
+  providerId: string
+  locationId?: string
+  name?: string
+  config: Record<string, unknown>
+  isActive: boolean
+  connectedBy?: string
+  connectedAt?: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface WebhookConfig {
+  id: string
+  tenantId: string
+  url: string
+  events: string[]
+  secret: string
+  isActive: boolean
+  createdBy: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface WebhookDelivery {
+  id: string
+  webhookId: string
+  event: string
+  payload: Record<string, unknown>
+  responseStatus?: number
+  success: boolean
+  attempts: number
+  createdAt: string
+}

package/src/shell/types/invite.ts

@@ -0,0 +1,23 @@
+export type InviteStatus = 'pending' | 'accepted' | 'expired' | 'revoked'
+
+export interface Invite {
+  id: string
+  tenantId: string
+  email: string
+  role: string
+  locationIds?: string[]
+  invitedBy: string
+  token: string
+  status: InviteStatus
+  expiresAt: string
+  acceptedAt?: string
+  createdAt: string
+  /** @deprecated Use tenantId */
+  orgId?: string
+  /** @deprecated */
+  profileId?: string
+  /** @deprecated */
+  profileName?: string
+  /** @deprecated */
+  invitedByName?: string
+}

package/src/shell/types/layout.ts

@@ -0,0 +1,29 @@
+import type React from 'react'
+
+export type LayoutVariant = 'sidebar' | 'topbar' | 'minimal' | (string & {})
+
+export interface NavigationItem {
+  id: string
+  label: string
+  icon: string
+  route: string
+  section: 'main' | 'secondary' | 'settings'
+  position: number
+  badge?: string | number
+  children?: NavigationItem[]
+}
+
+export interface LayoutConfig {
+  variant: LayoutVariant
+  navigation: NavigationItem[]
+  logo?: React.ReactNode
+  userMenu?: React.ReactNode
+  footer?: React.ReactNode
+}
+
+export interface LayoutState {
+  sidebarOpen: boolean
+  sidebarCollapsed: boolean
+  mobileDrawerOpen: boolean
+  commandPaletteOpen: boolean
+}

package/src/shell/types/notifications.ts

@@ -0,0 +1,33 @@
+export type NotificationType = 'info' | 'success' | 'warning' | 'error'
+export type NotificationChannel = 'in_app' | 'email' | 'push'
+export type NotificationCategory = 'inbox' | 'changelog'
+
+export interface Notification {
+  id: string
+  tenantId: string
+  userId: string
+  type: NotificationType
+  category?: NotificationCategory
+  title: string
+  body: string
+  channel: NotificationChannel
+  read: boolean
+  actionUrl?: string
+  metadata?: Record<string, unknown>
+  createdAt: string
+}
+
+export interface ChangelogEntry {
+  id: string
+  title: string
+  body: string
+  version?: string
+  date: string
+  type: 'feature' | 'improvement' | 'fix'
+}
+
+export interface NotificationState {
+  notifications: Notification[]
+  unreadCount: number
+  loading: boolean
+}