@elevasis/core 0.7.1 → 0.8.0

package/src/forms/index.ts

@@ -1,7 +1,7 @@
-/**
- * Shared form types and validation schemas
- * Used by Command Queue, Execution Runner UI, and other form-based features
- */
-
-export * from './types'
-export * from './schemas'
+/**
+ * Shared form types and validation schemas
+ * Used by Command Queue, Execution Runner UI, and other form-based features
+ */
+
+export * from './types'
+export * from './schemas'

package/src/forms/schemas.ts

@@ -1,69 +1,69 @@
-import { z } from 'zod'
-import type { FormField, FormSchema } from './types'
-
-/**
- * Zod validation schemas for form types
- * Provides runtime validation for form fields and schemas
- */
-
-/**
- * Form field schema validation
- */
-export const FormFieldSchema = z
-  .object({
-    name: z.string().min(1, 'Field name is required'),
-    label: z.string().min(1, 'Field label is required'),
-    type: z.enum(['text', 'textarea', 'number', 'select', 'checkbox', 'radio', 'richtext']),
-    defaultValue: z.unknown().optional(),
-    required: z.boolean().optional(),
-    placeholder: z.string().optional(),
-    description: z.string().optional(),
-    options: z
-      .array(
-        z.object({
-          label: z.string().min(1, 'Option label is required'),
-          value: z.union([z.string(), z.number()])
-        })
-      )
-      .optional(),
-    min: z.number().optional(),
-    max: z.number().optional(),
-    defaultValueFromContext: z.string().optional()
-  })
-  .refine(
-    (field) => {
-      // Validate that select/radio fields have options
-      if ((field.type === 'select' || field.type === 'radio') && (!field.options || field.options.length === 0)) {
-        return false
-      }
-      return true
-    },
-    {
-      message: 'Select and radio fields must have at least one option'
-    }
-  )
-
-/**
- * Form schema validation
- */
-export const FormSchemaSchema = z.object({
-  title: z.string().optional(),
-  description: z.string().optional(),
-  fields: z.array(FormFieldSchema).min(1, 'Form must have at least one field')
-})
-
-/**
- * Validates a form schema
- * @throws ZodError if validation fails
- */
-export function validateFormSchema(form: unknown): FormSchema {
-  return FormSchemaSchema.parse(form)
-}
-
-/**
- * Validates a form field
- * @throws ZodError if validation fails
- */
-export function validateFormField(field: unknown): FormField {
-  return FormFieldSchema.parse(field)
-}
+import { z } from 'zod'
+import type { FormField, FormSchema } from './types'
+
+/**
+ * Zod validation schemas for form types
+ * Provides runtime validation for form fields and schemas
+ */
+
+/**
+ * Form field schema validation
+ */
+export const FormFieldSchema = z
+  .object({
+    name: z.string().min(1, 'Field name is required'),
+    label: z.string().min(1, 'Field label is required'),
+    type: z.enum(['text', 'textarea', 'number', 'select', 'checkbox', 'radio', 'richtext']),
+    defaultValue: z.unknown().optional(),
+    required: z.boolean().optional(),
+    placeholder: z.string().optional(),
+    description: z.string().optional(),
+    options: z
+      .array(
+        z.object({
+          label: z.string().min(1, 'Option label is required'),
+          value: z.union([z.string(), z.number()])
+        })
+      )
+      .optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+    defaultValueFromContext: z.string().optional()
+  })
+  .refine(
+    (field) => {
+      // Validate that select/radio fields have options
+      if ((field.type === 'select' || field.type === 'radio') && (!field.options || field.options.length === 0)) {
+        return false
+      }
+      return true
+    },
+    {
+      message: 'Select and radio fields must have at least one option'
+    }
+  )
+
+/**
+ * Form schema validation
+ */
+export const FormSchemaSchema = z.object({
+  title: z.string().optional(),
+  description: z.string().optional(),
+  fields: z.array(FormFieldSchema).min(1, 'Form must have at least one field')
+})
+
+/**
+ * Validates a form schema
+ * @throws ZodError if validation fails
+ */
+export function validateFormSchema(form: unknown): FormSchema {
+  return FormSchemaSchema.parse(form)
+}
+
+/**
+ * Validates a form field
+ * @throws ZodError if validation fails
+ */
+export function validateFormField(field: unknown): FormField {
+  return FormFieldSchema.parse(field)
+}

package/src/forms/types.ts

@@ -1,70 +1,70 @@
-/**
- * Shared form field types for dynamic form generation
- * Used by: Command Queue, Execution Runner UI, future form-based features
- */
-
-/**
- * Supported form field types for action payloads
- * Maps to Mantine form components
- */
-export type FormFieldType =
-  | 'text'       // TextInput
-  | 'textarea'   // Textarea
-  | 'number'     // NumberInput
-  | 'select'     // Select dropdown
-  | 'checkbox'   // Checkbox
-  | 'radio'      // Radio group
-  | 'richtext'   // Rich text editor (TipTap)
-
-/**
- * Form field definition
- */
-export interface FormField {
-  /** Field key in payload object */
-  name: string
-
-  /** Field label for UI */
-  label: string
-
-  /** Field type (determines UI component) */
-  type: FormFieldType
-
-  /** Default value */
-  defaultValue?: unknown
-
-  /** Required field */
-  required?: boolean
-
-  /** Placeholder text */
-  placeholder?: string
-
-  /** Help text */
-  description?: string
-
-  /** Options for select/radio */
-  options?: Array<{
-    label: string
-    value: string | number
-  }>
-
-  /** Min/max for number */
-  min?: number
-  max?: number
-
-  /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
-  defaultValueFromContext?: string
-}
-
-/**
- * Form schema for action payload collection
- */
-export interface FormSchema {
-  /** Form title */
-  title?: string
-
-  /** Form description */
-  description?: string
-
-  /** Form fields */
-  fields: FormField[]
-}
+/**
+ * Shared form field types for dynamic form generation
+ * Used by: Command Queue, Execution Runner UI, future form-based features
+ */
+
+/**
+ * Supported form field types for action payloads
+ * Maps to Mantine form components
+ */
+export type FormFieldType =
+  | 'text'       // TextInput
+  | 'textarea'   // Textarea
+  | 'number'     // NumberInput
+  | 'select'     // Select dropdown
+  | 'checkbox'   // Checkbox
+  | 'radio'      // Radio group
+  | 'richtext'   // Rich text editor (TipTap)
+
+/**
+ * Form field definition
+ */
+export interface FormField {
+  /** Field key in payload object */
+  name: string
+
+  /** Field label for UI */
+  label: string
+
+  /** Field type (determines UI component) */
+  type: FormFieldType
+
+  /** Default value */
+  defaultValue?: unknown
+
+  /** Required field */
+  required?: boolean
+
+  /** Placeholder text */
+  placeholder?: string
+
+  /** Help text */
+  description?: string
+
+  /** Options for select/radio */
+  options?: Array<{
+    label: string
+    value: string | number
+  }>
+
+  /** Min/max for number */
+  min?: number
+  max?: number
+
+  /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
+  defaultValueFromContext?: string
+}
+
+/**
+ * Form schema for action payload collection
+ */
+export interface FormSchema {
+  /** Form title */
+  title?: string
+
+  /** Form description */
+  description?: string
+
+  /** Form fields */
+  fields: FormField[]
+}

package/src/index.ts

@@ -1,64 +1,75 @@
-/**
- * Main exports for @repo/core package
- *
- * ⚠️ BROWSER-SAFE EXPORTS ONLY
- * This entry point is imported by frontend apps (command-center).
- * DO NOT export anything that uses Node.js APIs (process.env, crypto, fs, etc.)
- * Server-only exports belong in ./server.ts
- *
- * For scoped imports, prefer:
- *   import { ... } from '@repo/core/platform'
- *   import { ... } from '@repo/core/execution'
- *   import { ... } from '@repo/core/operations'
- * etc.
- */
-
-// === Domain Groups ===
-
-// Platform: constants, utilities, registry, SSE, API types
-export * from './platform'
-
-// Auth: multi-tenancy types
-export * from './auth'
-
-// Execution: engine, core types, scheduler
-export * from './execution'
-
-// Commands: command queue types
-export * from './commands'
-
-// Deployments: deployment response types
-export * from './deployments'
-
-// Operations: sessions, notifications, debug logs, observability, activities, triggers
-export * from './operations'
-
-// Business: acquisition types (PDF has own subpath exports)
-export * from './business'
-
-// Organization model: semantic layer for downstream business semantics
-export * from './organization-model'
-
-// === Standalone (cross-cutting or independent) ===
-
-// Supabase types
-export * from './supabase/index'
-
-// Shared form types (used by Command Queue, Execution Runner UI, etc.)
-export * from './forms/index'
-
-// OAuth integration types
-export * from './integrations/oauth/index'
-
-// Credential types and utilities
-export * from './integrations/credentials/index'
-
-// Scaffold registry — browser-safe schema types and Zod schemas only.
-// For server-side loader functions, use: import { ... } from '@repo/core/scaffold-registry'
-export { ScaffoldRegistrySchema, ScaffoldEntryKindSchema } from './scaffold-registry/schema'
+/**
+ * Main exports for @repo/core package
+ *
+ * ⚠️ BROWSER-SAFE EXPORTS ONLY
+ * This entry point is imported by frontend apps (command-center).
+ * DO NOT export anything that uses Node.js APIs (process.env, crypto, fs, etc.)
+ * Server-only exports belong in ./server.ts
+ *
+ * For scoped imports, prefer:
+ *   import { ... } from '@repo/core/platform'
+ *   import { ... } from '@repo/core/execution'
+ *   import { ... } from '@repo/core/operations'
+ * etc.
+ */
+
+// === Domain Groups ===
+
+// Platform: constants, utilities, registry, SSE, API types
+export * from './platform'
+
+// Auth: multi-tenancy types
+export * from './auth'
+
+// Execution: engine, core types, scheduler
+export * from './execution'
+
+// Commands: command queue types
+export * from './commands'
+
+// Deployments: deployment response types
+export * from './deployments'
+
+// Operations: sessions, notifications, debug logs, observability, activities, triggers
+export * from './operations'
+
+// Business: acquisition types (PDF has own subpath exports)
+export * from './business'
+
+// Organization model: semantic layer for downstream business semantics
+export * from './organization-model'
+
+// === Standalone (cross-cutting or independent) ===
+
+// Supabase types
+export * from './supabase/index'
+
+// Shared form types (used by Command Queue, Execution Runner UI, etc.)
+export * from './forms/index'
+
+// OAuth integration types
+export * from './integrations/oauth/index'
+
+// Credential types and utilities
+export * from './integrations/credentials/index'
+
+// Scaffold registry — browser-safe schema types and Zod schemas only.
+// For server-side loader functions, use: import { ... } from '@repo/core/scaffold-registry'
+export {
+  ExternalSyncCategorySchema,
+  ExternalSyncDeletePolicySchema,
+  ExternalSyncOwnerSchema,
+  ExternalSyncStrategySchema,
+  ScaffoldEntryKindSchema,
+  ScaffoldRegistrySchema
+} from './scaffold-registry/schema'
 export type {
+  ExternalSyncCategory,
+  ExternalSyncDeletePolicy,
+  ExternalSyncOwner,
+  ExternalSyncStrategy,
+  ScaffoldEntryKind,
   ScaffoldRegistry,
   ScaffoldRegistryEntry,
-  ScaffoldRef,
-  ScaffoldEntryKind
+  ScaffoldRef
 } from './scaffold-registry/schema'

package/src/integrations/credentials/__tests__/schemas.test.ts

@@ -1,82 +1,82 @@
-import { describe, it, expect } from 'vitest'
-import { CREDENTIAL_SCHEMAS, getCredentialSchema, listCredentialSchemas, getCredentialTypes } from '../schemas'
-
-describe('Credential Schema Registry', () => {
-  describe('CREDENTIAL_SCHEMAS', () => {
-    it('should have OAuth schemas', () => {
-      expect(CREDENTIAL_SCHEMAS['google-sheets']).toBeDefined()
-      expect(CREDENTIAL_SCHEMAS['google-sheets'].type).toBe('oauth')
-      expect(CREDENTIAL_SCHEMAS['google-sheets'].oauthProvider).toBe('google-sheets')
-
-      expect(CREDENTIAL_SCHEMAS.dropbox).toBeDefined()
-      expect(CREDENTIAL_SCHEMAS.dropbox.type).toBe('oauth')
-      expect(CREDENTIAL_SCHEMAS.dropbox.oauthProvider).toBe('dropbox')
-    })
-
-    it('should have api-key single-field schema', () => {
-      expect(CREDENTIAL_SCHEMAS['api-key']).toBeDefined()
-      expect(CREDENTIAL_SCHEMAS['api-key'].type).toBe('single_field')
-      expect(CREDENTIAL_SCHEMAS['api-key'].fields).toHaveLength(1)
-      expect(CREDENTIAL_SCHEMAS['api-key'].fields?.[0].key).toBe('apiKey')
-    })
-  })
-
-  describe('getCredentialSchema', () => {
-    it('should return schema for valid type', () => {
-      const schema = getCredentialSchema('google-sheets')
-      expect(schema).toStrictEqual(CREDENTIAL_SCHEMAS['google-sheets'])
-    })
-
-    it('should return api-key schema for unknown type', () => {
-      const schema = getCredentialSchema('unknown')
-      expect(schema).toStrictEqual(CREDENTIAL_SCHEMAS['api-key'])
-    })
-
-    it('should validate schema with Zod', () => {
-      // Should not throw - schemas are valid
-      expect(() => getCredentialSchema('google-sheets')).not.toThrow()
-      expect(() => getCredentialSchema('api-key')).not.toThrow()
-    })
-
-    it('should return OAuth schemas correctly', () => {
-      const googleSheetsSchema = getCredentialSchema('google-sheets')
-      expect(googleSheetsSchema.type).toBe('oauth')
-      expect(googleSheetsSchema.oauthProvider).toBe('google-sheets')
-      expect(googleSheetsSchema.fields).toBeUndefined()
-    })
-  })
-
-  describe('listCredentialSchemas', () => {
-    it('should return all schemas as array', () => {
-      const schemas = listCredentialSchemas()
-      expect(schemas.length).toBeGreaterThan(0)
-      expect(schemas).toContainEqual(CREDENTIAL_SCHEMAS['google-sheets'])
-      expect(schemas).toContainEqual(CREDENTIAL_SCHEMAS['api-key'])
-    })
-
-    it('should return array with correct schema structure', () => {
-      const schemas = listCredentialSchemas()
-      schemas.forEach((schema) => {
-        expect(schema).toHaveProperty('type')
-        expect(schema).toHaveProperty('label')
-        expect(schema).toHaveProperty('description')
-        expect(schema).toHaveProperty('nameSuggestions')
-      })
-    })
-  })
-
-  describe('getCredentialTypes', () => {
-    it('should return all type keys', () => {
-      const types = getCredentialTypes()
-      expect(types).toContain('dropbox')
-      expect(types).toContain('google-sheets')
-      expect(types).toContain('api-key')
-    })
-
-    it('should return unique types', () => {
-      const types = getCredentialTypes()
-      const uniqueTypes = [...new Set(types)]
-      expect(types).toEqual(uniqueTypes)
-    })
-  })
-})
+import { describe, it, expect } from 'vitest'
+import { CREDENTIAL_SCHEMAS, getCredentialSchema, listCredentialSchemas, getCredentialTypes } from '../schemas'
+
+describe('Credential Schema Registry', () => {
+  describe('CREDENTIAL_SCHEMAS', () => {
+    it('should have OAuth schemas', () => {
+      expect(CREDENTIAL_SCHEMAS['google-sheets']).toBeDefined()
+      expect(CREDENTIAL_SCHEMAS['google-sheets'].type).toBe('oauth')
+      expect(CREDENTIAL_SCHEMAS['google-sheets'].oauthProvider).toBe('google-sheets')
+
+      expect(CREDENTIAL_SCHEMAS.dropbox).toBeDefined()
+      expect(CREDENTIAL_SCHEMAS.dropbox.type).toBe('oauth')
+      expect(CREDENTIAL_SCHEMAS.dropbox.oauthProvider).toBe('dropbox')
+    })
+
+    it('should have api-key single-field schema', () => {
+      expect(CREDENTIAL_SCHEMAS['api-key']).toBeDefined()
+      expect(CREDENTIAL_SCHEMAS['api-key'].type).toBe('single_field')
+      expect(CREDENTIAL_SCHEMAS['api-key'].fields).toHaveLength(1)
+      expect(CREDENTIAL_SCHEMAS['api-key'].fields?.[0].key).toBe('apiKey')
+    })
+  })
+
+  describe('getCredentialSchema', () => {
+    it('should return schema for valid type', () => {
+      const schema = getCredentialSchema('google-sheets')
+      expect(schema).toStrictEqual(CREDENTIAL_SCHEMAS['google-sheets'])
+    })
+
+    it('should return api-key schema for unknown type', () => {
+      const schema = getCredentialSchema('unknown')
+      expect(schema).toStrictEqual(CREDENTIAL_SCHEMAS['api-key'])
+    })
+
+    it('should validate schema with Zod', () => {
+      // Should not throw - schemas are valid
+      expect(() => getCredentialSchema('google-sheets')).not.toThrow()
+      expect(() => getCredentialSchema('api-key')).not.toThrow()
+    })
+
+    it('should return OAuth schemas correctly', () => {
+      const googleSheetsSchema = getCredentialSchema('google-sheets')
+      expect(googleSheetsSchema.type).toBe('oauth')
+      expect(googleSheetsSchema.oauthProvider).toBe('google-sheets')
+      expect(googleSheetsSchema.fields).toBeUndefined()
+    })
+  })
+
+  describe('listCredentialSchemas', () => {
+    it('should return all schemas as array', () => {
+      const schemas = listCredentialSchemas()
+      expect(schemas.length).toBeGreaterThan(0)
+      expect(schemas).toContainEqual(CREDENTIAL_SCHEMAS['google-sheets'])
+      expect(schemas).toContainEqual(CREDENTIAL_SCHEMAS['api-key'])
+    })
+
+    it('should return array with correct schema structure', () => {
+      const schemas = listCredentialSchemas()
+      schemas.forEach((schema) => {
+        expect(schema).toHaveProperty('type')
+        expect(schema).toHaveProperty('label')
+        expect(schema).toHaveProperty('description')
+        expect(schema).toHaveProperty('nameSuggestions')
+      })
+    })
+  })
+
+  describe('getCredentialTypes', () => {
+    it('should return all type keys', () => {
+      const types = getCredentialTypes()
+      expect(types).toContain('dropbox')
+      expect(types).toContain('google-sheets')
+      expect(types).toContain('api-key')
+    })
+
+    it('should return unique types', () => {
+      const types = getCredentialTypes()
+      const uniqueTypes = [...new Set(types)]
+      expect(types).toEqual(uniqueTypes)
+    })
+  })
+})