@elevasis/core 0.17.0 → 0.19.0

package/src/_gen/__tests__/__snapshots__/contracts.md.snap

@@ -195,6 +195,18 @@ export type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>
 export type OrgKnowledgeKind = z.infer<typeof OrgKnowledgeKindSchema>
 ```
 
+### `KnowledgeSkillBinding`
+
+```typescript
+export type KnowledgeSkillBinding = z.infer<typeof KnowledgeSkillBindingSchema>
+```
+
+### `KnowledgeDomainBinding`
+
+```typescript
+export type KnowledgeDomainBinding = z.infer<typeof KnowledgeDomainBindingSchema>
+```
+
 ### `OrganizationModelIconToken`
 
 ```typescript
@@ -866,7 +878,9 @@ export interface AcqCompany {
   category: string | null
   categoryPain: string | null
   segment: string | null
-  pipelineStatus: CompanyPipelineStatus | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: CompanyEnrichmentData | null
   source: string | null
   batchId: string | null
@@ -906,7 +920,9 @@ export interface AcqContact {
   openingLine: string | null
   source: string | null
   sourceId: string | null
-  pipelineStatus: ContactPipelineStatus | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: ContactEnrichmentData | null
   /** Attio Person record ID - set when contact responds and is added to CRM */
   attioPersonId: string | null
@@ -969,7 +985,7 @@ export interface DealContact {
   title: string | null
   headline: string | null
   linkedin_url: string | null
-  pipeline_status: Record<string, unknown> | null
+  processing_state: Record<string, unknown> | null
   enrichment_data: Record<string, unknown> | null
   company: {
     id: string
@@ -1242,7 +1258,7 @@ export const DealContactSummarySchema = z.object({
   title: z.string().nullable(),
   headline: z.string().nullable(),
   linkedin_url: z.string().nullable(),
-  pipeline_status: z.record(z.string(), z.unknown()).nullable(),
+  processing_state: ProcessingStateSchema.nullable(),
   enrichment_data: z.record(z.string(), z.unknown()).nullable(),
   company: z
     .object({
@@ -1570,51 +1586,6 @@ export interface WebPost {
 }
 ```
 
-### `CompanyPipelineStatus`
-
-```typescript
-/**
- * Tracks pipeline status for a company across all processing stages.
- */
-export interface CompanyPipelineStatus {
-  acquired: boolean
-  enrichment: {
-    [source: string]: {
-      status: 'pending' | 'complete' | 'failed' | 'skipped'
-      completedAt?: string
-      error?: string
-    }
-  }
-}
-```
-
-### `ContactPipelineStatus`
-
-```typescript
-/**
- * Tracks pipeline status for a contact across all processing stages.
- */
-export interface ContactPipelineStatus {
-  enrichment: {
-    [source: string]: {
-      status: 'pending' | 'complete' | 'failed' | 'skipped'
-      completedAt?: string
-      error?: string
-    }
-  }
-  personalization: {
-    status: 'pending' | 'complete' | 'failed' | 'skipped'
-    completedAt?: string
-  }
-  outreach: {
-    status: 'pending' | 'sent' | 'replied' | 'bounced' | 'opted-out'
-    sentAt?: string
-    channel?: string
-    campaignId?: string
-  }
-}
-```
-
 ### `CompanyEnrichmentData`
 
 ```typescript
@@ -1730,7 +1701,9 @@ export interface AcqCompany {
   category: string | null
   categoryPain: string | null
   segment: string | null
-  pipelineStatus: CompanyPipelineStatus | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: CompanyEnrichmentData | null
   source: string | null
   batchId: string | null
@@ -1770,7 +1743,9 @@ export interface AcqContact {
   openingLine: string | null
   source: string | null
   sourceId: string | null
-  pipelineStatus: ContactPipelineStatus | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: ContactEnrichmentData | null
   /** Attio Person record ID - set when contact responds and is added to CRM */
   attioPersonId: string | null
@@ -2081,6 +2056,7 @@ export const ListCompaniesQuerySchema = z
     website: z.string().trim().min(1).max(2048).optional(),
     segment: z.string().trim().min(1).max(255).optional(),
     category: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional(),
     batchId: z.string().trim().min(1).max(255).optional(),
     status: AcqCompanyStatusSchema.optional(),
     includeAll: QueryBooleanSchema.optional(),
@@ -2122,6 +2098,7 @@ export const CreateCompanyRequestSchema = z
     category: z.string().trim().min(1).max(255).optional(),
     source: z.string().trim().min(1).max(255).optional(),
     batchId: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional(),
     verticalResearch: z.string().trim().min(1).max(5000).optional()
   })
   .strict()
@@ -2142,7 +2119,8 @@ export const UpdateCompanyRequestSchema = z
     locationState: z.string().trim().min(1).max(255).optional(),
     category: z.string().trim().min(1).max(255).optional(),
     segment: z.string().trim().min(1).max(255).optional(),
-    pipelineStatus: z.record(z.string(), z.unknown()).optional(),
+    processingState: CompanyProcessingStateSchema.optional(),
+    pipelineStatus: z.unknown().optional(),
     enrichmentData: z.record(z.string(), z.unknown()).optional(),
     source: z.string().trim().min(1).max(255).optional(),
     batchId: z.string().trim().min(1).max(255).optional(),
@@ -2162,6 +2140,7 @@ export const UpdateCompanyRequestSchema = z
       data.locationState !== undefined ||
       data.category !== undefined ||
       data.segment !== undefined ||
+      data.processingState !== undefined ||
       data.pipelineStatus !== undefined ||
       data.enrichmentData !== undefined ||
       data.source !== undefined ||
@@ -2187,7 +2166,8 @@ export const CreateContactRequestSchema = z
     title: z.string().trim().min(1).max(255).optional(),
     source: z.string().trim().min(1).max(255).optional(),
     sourceId: z.string().trim().min(1).max(255).optional(),
-    batchId: z.string().trim().min(1).max(255).optional()
+    batchId: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.unknown().optional()
   })
   .strict()
 ```
@@ -2206,7 +2186,8 @@ export const UpdateContactRequestSchema = z
     headline: z.string().trim().min(1).max(5000).optional(),
     filterReason: z.string().trim().min(1).max(5000).optional(),
     openingLine: z.string().trim().min(1).max(5000).optional(),
-    pipelineStatus: z.record(z.string(), z.unknown()).optional(),
+    processingState: ContactProcessingStateSchema.optional(),
+    pipelineStatus: z.unknown().optional(),
     enrichmentData: z.record(z.string(), z.unknown()).optional(),
     status: AcqContactStatusSchema.optional()
   })
@@ -2222,6 +2203,7 @@ export const UpdateContactRequestSchema = z
       data.headline !== undefined ||
       data.filterReason !== undefined ||
       data.openingLine !== undefined ||
+      data.processingState !== undefined ||
       data.pipelineStatus !== undefined ||
       data.enrichmentData !== undefined ||
       data.status !== undefined,
@@ -2248,7 +2230,8 @@ export const AcqCompanyResponseSchema = z.object({
   category: z.string().nullable(),
   categoryPain: z.string().nullable(),
   segment: z.string().nullable(),
-  pipelineStatus: z.record(z.string(), z.unknown()).nullable(),
+  processingState: CompanyProcessingStateSchema.nullable(),
+  pipelineStatus: z.unknown().nullable().optional(),
   enrichmentData: z.record(z.string(), z.unknown()).nullable(),
   source: z.string().nullable(),
   batchId: z.string().nullable(),
@@ -2314,7 +2297,8 @@ export const AcqContactResponseSchema = z.object({
   openingLine: z.string().nullable(),
   source: z.string().nullable(),
   sourceId: z.string().nullable(),
-  pipelineStatus: z.record(z.string(), z.unknown()).nullable(),
+  processingState: ContactProcessingStateSchema.nullable(),
+  pipelineStatus: z.unknown().nullable().optional(),
   enrichmentData: z.record(z.string(), z.unknown()).nullable(),
   attioPersonId: z.string().nullable(),
   batchId: z.string().nullable(),
@@ -2480,6 +2464,7 @@ export const AcqListCompanyResponseSchema = z.object({
 
 ```typescript
 export const AcqCompanySchemas = {
+  CompanyProcessingState: CompanyProcessingStateSchema,
   CompanyIdParams: CompanyIdParamsSchema,
   ListCompaniesQuery: ListCompaniesQuerySchema,
   CreateCompanyRequest: CreateCompanyRequestSchema,
@@ -2494,6 +2479,7 @@ export const AcqCompanySchemas = {
 
 ```typescript
 export const AcqContactSchemas = {
+  ContactProcessingState: ContactProcessingStateSchema,
   ContactIdParams: ContactIdParamsSchema,
   ListContactsQuery: ListContactsQuerySchema,
   CreateContactRequest: CreateContactRequestSchema,
@@ -2519,7 +2505,10 @@ export const AcqListSchemas = {
   BuildPlanSnapshot: BuildPlanSnapshotSchema,
   BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
   AcqListMetadata: AcqListMetadataSchema,
+  LeadGenStageKey: LeadGenStageKeySchema,
+  LeadGenCapabilityKey: LeadGenCapabilityKeySchema,
   ProcessingStageStatus: ProcessingStageStatusSchema,
+  ProcessingState: ProcessingStateSchema,
   ListStageCounts: ListStageCountsSchema,
   ListTelemetry: ListTelemetrySchema,
 
@@ -2812,6 +2801,8 @@ export interface CreateCompanyParams {
   source?: string
   batchId?: string
   verticalResearch?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
@@ -2829,7 +2820,9 @@ export interface UpdateCompanyParams {
   locationState?: string
   category?: string
   segment?: string
-  pipelineStatus?: Record<string, unknown>
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
   enrichmentData?: Record<string, unknown>
   source?: string
   batchId?: string
@@ -2837,7 +2830,7 @@ export interface UpdateCompanyParams {
   verticalResearch?: string | null
   /** Track A: flat qualification score column (null until a scoring rubric is defined) */
   qualificationScore?: number | null
-  /** Track A: flat qualification signals jsonb — mirrors the former pipeline_status.qualification shape */
+  /** Track A: flat qualification signals jsonb */
   qualificationSignals?: Record<string, unknown> | null
   /** Track A: key identifying the rubric used for qualification */
   qualificationRubricKey?: string | null
@@ -2860,13 +2853,15 @@ export interface CompanyFilters {
   website?: string
   segment?: string
   category?: string
-  pipelineStatus?: Record<string, unknown>
-  /** Exclude companies whose pipeline_status contains this value (PostgREST NOT contains) */
-  pipelineStatusNot?: Record<string, unknown>
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
+  processingStateNot?: ProcessingState
   batchId?: string
   status?: 'active' | 'invalid'
   includeAll?: boolean
-  excludeColumns?: Array<'enrichmentData' | 'pipelineStatus'>
+  excludeColumns?: Array<'enrichmentData' | 'processingState'>
   limit?: number
 }
 ```
@@ -2885,6 +2880,8 @@ export interface CreateContactParams {
   source?: string
   sourceId?: string
   batchId?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
@@ -2901,7 +2898,9 @@ export interface UpdateContactParams {
   headline?: string
   filterReason?: string
   openingLine?: string
-  pipelineStatus?: Record<string, unknown>
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
   enrichmentData?: Record<string, unknown>
   status?: 'active' | 'invalid'
 }
@@ -2920,7 +2919,9 @@ export interface ContactFilters {
   listId?: string // Filter to contacts in a specific list (via acq_list_members)
   search?: string
   openingLineIsNull?: boolean // Filter to contacts without personalization
-  pipelineStatus?: Record<string, unknown>
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
   batchId?: string
   contactStatus?: 'active' | 'invalid' // Filter by contact status (soft-delete flag)
 }
@@ -3119,7 +3120,7 @@ export interface BulkImportCompanyEntry {
   category?: string
   source?: string
   enrichmentData?: Record<string, unknown>
-  pipelineStatus?: Record<string, unknown>
+  processingState?: ProcessingState
 }
 ```
 
@@ -3300,6 +3301,14 @@ export type ListToolMap = {
     params: Omit<UpdateContactStageParams, 'organizationId'>
     result: void
   }
+  listPendingCompanyIds: {
+    params: Omit<ListPendingCompanyIdsParams, 'organizationId'>
+    result: string[]
+  }
+  listPendingContactIds: {
+    params: Omit<ListPendingContactIdsParams, 'organizationId'>
+    result: string[]
+  }
 }
 ```
 
@@ -3335,6 +3344,10 @@ export const OrgKnowledgeNodeSchema = z.object({
    * Each link emits a `governs` edge: knowledge-node -> target node.
    */
   links: z.array(KnowledgeLinkSchema).default([]),
+  /** Operator skill or command bindings relevant to this node. */
+  skills: z.array(KnowledgeSkillBindingSchema).optional(),
+  /** Domain key used to derive fast graph->skill registries. */
+  domain: KnowledgeDomainBindingSchema.optional(),
   /** Identifiers of the roles or members who own this knowledge node. */
   ownerIds: z.array(ModelIdSchema).default([]),
   /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */

package/src/auth/multi-tenancy/organizations/__tests__/api-schemas.test.ts

@@ -0,0 +1,194 @@
+import { describe, expect, it } from 'vitest'
+import { CreateOrganizationSchema, ListOrganizationsQuerySchema, UpdateOrganizationSchema } from '../api-schemas'
+
+// ---------------------------------------------------------------------------
+// CreateOrganizationSchema
+// ---------------------------------------------------------------------------
+
+describe('CreateOrganizationSchema', () => {
+  it('accepts a minimal valid payload (name only)', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme Corp' }).success).toBe(true)
+  })
+
+  it('accepts name at minimum length boundary (2 chars)', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'AB' }).success).toBe(true)
+  })
+
+  it('accepts name at maximum length boundary (100 chars)', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'A'.repeat(100) }).success).toBe(true)
+  })
+
+  it('rejects name shorter than 2 characters', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'A' }).success).toBe(false)
+    expect(CreateOrganizationSchema.safeParse({ name: '' }).success).toBe(false)
+  })
+
+  it('rejects name longer than 100 characters', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'A'.repeat(101) }).success).toBe(false)
+  })
+
+  it('accepts names with letters, numbers, spaces, hyphens, and underscores', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'My Org-123_Test' }).success).toBe(true)
+  })
+
+  it('rejects names with disallowed characters (special symbols)', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme@Corp' }).success).toBe(false)
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme.Corp' }).success).toBe(false)
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme/Corp' }).success).toBe(false)
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme+Corp' }).success).toBe(false)
+  })
+
+  it('accepts optional domainData array with valid entries', () => {
+    const result = CreateOrganizationSchema.safeParse({
+      name: 'Acme Corp',
+      domainData: [{ domain: 'acme.com', state: 'verified' }]
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts domainData up to 10 entries', () => {
+    const domains = Array.from({ length: 10 }, (_, i) => ({ domain: `domain${i}.com` }))
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme Corp', domainData: domains }).success).toBe(true)
+  })
+
+  it('rejects domainData with more than 10 entries', () => {
+    const domains = Array.from({ length: 11 }, (_, i) => ({ domain: `domain${i}.com` }))
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme Corp', domainData: domains }).success).toBe(false)
+  })
+
+  it('accepts optional metadata as a record under 10KB', () => {
+    const result = CreateOrganizationSchema.safeParse({
+      name: 'Acme Corp',
+      metadata: { plan: 'pro', region: 'us-west' }
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects metadata exceeding 10KB (10240 bytes)', () => {
+    // Build a metadata object whose JSON representation exceeds 10240 bytes
+    const largeValue = 'x'.repeat(10241)
+    const result = CreateOrganizationSchema.safeParse({
+      name: 'Acme Corp',
+      metadata: { big: largeValue }
+    })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects unknown top-level fields (.strict() mode)', () => {
+    expect(CreateOrganizationSchema.safeParse({ name: 'Acme Corp', unknownField: 'value' }).success).toBe(false)
+  })
+
+  it('rejects missing name field', () => {
+    expect(CreateOrganizationSchema.safeParse({}).success).toBe(false)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// UpdateOrganizationSchema
+// ---------------------------------------------------------------------------
+
+describe('UpdateOrganizationSchema', () => {
+  it('rejects an empty object (at least one field required)', () => {
+    // UpdateOrganizationSchema is CreateOrganizationSchema.partial().strict().refine(...)
+    // The .refine() enforces the documented "at least one field" convention
+    // (see .claude/rules/core-package.md → "api-schemas.ts Pattern")
+    const result = UpdateOrganizationSchema.safeParse({})
+    expect(result.success).toBe(false)
+    if (!result.success) {
+      expect(result.error.issues[0].message).toMatch(/at least one field/i)
+    }
+  })
+
+  it('accepts updating only name', () => {
+    expect(UpdateOrganizationSchema.safeParse({ name: 'New Name' }).success).toBe(true)
+  })
+
+  it('accepts updating only domainData', () => {
+    expect(UpdateOrganizationSchema.safeParse({ domainData: [{ domain: 'newdomain.com' }] }).success).toBe(true)
+  })
+
+  it('accepts updating only metadata', () => {
+    expect(UpdateOrganizationSchema.safeParse({ metadata: { key: 'value' } }).success).toBe(true)
+  })
+
+  it('applies same name validation as CreateOrganizationSchema when name is provided', () => {
+    // Too short
+    expect(UpdateOrganizationSchema.safeParse({ name: 'A' }).success).toBe(false)
+    // Too long
+    expect(UpdateOrganizationSchema.safeParse({ name: 'A'.repeat(101) }).success).toBe(false)
+    // Invalid charset
+    expect(UpdateOrganizationSchema.safeParse({ name: 'Bad@Name' }).success).toBe(false)
+    // Valid
+    expect(UpdateOrganizationSchema.safeParse({ name: 'Good Name-123' }).success).toBe(true)
+  })
+
+  it('applies same domainData max-10 validation when provided', () => {
+    const tooMany = Array.from({ length: 11 }, (_, i) => ({ domain: `d${i}.com` }))
+    expect(UpdateOrganizationSchema.safeParse({ domainData: tooMany }).success).toBe(false)
+  })
+
+  it('applies same metadata 10KB cap validation when provided', () => {
+    const largeValue = 'x'.repeat(10241)
+    expect(UpdateOrganizationSchema.safeParse({ metadata: { big: largeValue } }).success).toBe(false)
+  })
+
+  it('rejects unknown top-level fields (.strict() mode)', () => {
+    expect(UpdateOrganizationSchema.safeParse({ name: 'Valid Name', unknownField: 'bad' }).success).toBe(false)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// ListOrganizationsQuerySchema
+// ---------------------------------------------------------------------------
+
+describe('ListOrganizationsQuerySchema', () => {
+  it('accepts an empty query and applies default limit of 20', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({})
+    expect(result.success).toBe(true)
+    if (result.success) {
+      expect(result.data.limit).toBe(20)
+    }
+  })
+
+  it('coerces limit from string "50" to number 50', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({ limit: '50' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.limit).toBe(50)
+  })
+
+  it('accepts limit at upper boundary (100)', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({ limit: '100' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.limit).toBe(100)
+  })
+
+  it('accepts limit at lower boundary (1)', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({ limit: '1' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.limit).toBe(1)
+  })
+
+  it('rejects limit of 101 (above max 100)', () => {
+    expect(ListOrganizationsQuerySchema.safeParse({ limit: '101' }).success).toBe(false)
+  })
+
+  it('rejects limit of 0 (below min 1)', () => {
+    expect(ListOrganizationsQuerySchema.safeParse({ limit: '0' }).success).toBe(false)
+  })
+
+  it('accepts optional before cursor string', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({ before: 'cursor_abc123' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.before).toBe('cursor_abc123')
+  })
+
+  it('accepts optional after cursor string', () => {
+    const result = ListOrganizationsQuerySchema.safeParse({ after: 'cursor_xyz789' })
+    expect(result.success).toBe(true)
+    if (result.success) expect(result.data.after).toBe('cursor_xyz789')
+  })
+
+  it('accepts both before and after cursors together', () => {
+    expect(ListOrganizationsQuerySchema.safeParse({ before: 'a', after: 'b' }).success).toBe(true)
+  })
+})