@stacksjs/types 0.70.73 → 0.70.74

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 import type { BunFile } from 'bun';
 import type { Ports } from './ports';
 export type { ErrorLike, SpawnOptions, Subprocess, SyncSubprocess } from 'bun';
-export type { CAC as CLI } from 'cac';
+export type { CLI } from '@stacksjs/clapp';
 export declare interface OutroOptions extends CliOptions {
   type?: 'success' | 'error' | 'warning' | 'info'
   startTime?: number

package/dist/email.d.ts

@@ -108,7 +108,7 @@ export declare interface EmailOptions {
   charset: string
   server: EmailServerConfig
   notifications?: EmailNotificationsConfig
-  default: 'log' | 'ses' | 'sendgrid' | 'mailgun' | 'mailtrap' | 'smtp'
+  default: 'log' | 'capture' | 'ses' | 'sendgrid' | 'mailgun' | 'mailtrap' | 'smtp'
   suppressionPolicy?: 'strict' | 'transactional-allowed' | 'off'
   unsubscribeRoute?: string
 }

package/dist/model.d.ts

@@ -196,6 +196,8 @@ export declare interface ModelOptions extends Base {
   }
 }
 export declare interface Attribute {
+  type?: string
+  nullable?: boolean
   default?: string | number | boolean | Date
   unique?: boolean
   order?: number

package/dist/phone.d.ts

@@ -40,6 +40,17 @@ export declare interface PhoneNotificationsConfig {
   missedCall?: PhoneNotificationConfig
   voicemail?: PhoneNotificationConfig
 }
+export declare interface CallForwardingRule {
+  name: string
+  condition: CallForwardingCondition
+  forwardTo: string
+  ringTimeout: number
+  priority: number
+}
+export declare interface CallForwardingConfig {
+  enabled: boolean
+  rules: CallForwardingRule[]
+}
 export declare interface PhoneOptions {
   enabled: boolean
   provider: 'connect'
@@ -47,6 +58,8 @@ export declare interface PhoneOptions {
   phoneNumbers: PhoneNumberConfig[]
   notifications: PhoneNotificationsConfig
   voicemail: VoicemailConfig
+  forwarding?: CallForwardingConfig
   businessHours?: BusinessHoursConfig
 }
+export type CallForwardingCondition = 'always' | 'business_hours' | 'after_hours';
 export type PhoneConfig = Partial<PhoneOptions>;

package/dist/request.d.ts

@@ -1,7 +1,6 @@
 import { User } from '@stacksjs/orm';
 import type { AuthToken } from '@stacksjs/types';
 import type { Infer } from '@stacksjs/ts-validation';
-import type { ModelRow } from '@stacksjs/orm';
 import type { UploadedFile } from '@stacksjs/storage';
 declare interface RequestData {
   [key: string]: any
@@ -77,15 +76,17 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   formBody?: any
   files: Record<string, File | File[]>
   cookies?: RequestCookies
-  get: <K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]) => TFields[K]
-  input: <K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]) => TFields[K]
+  get<K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]): TFields[K]
+  get<T = any>(key: string, defaultValue?: T): T
+  input<K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]): TFields[K]
+  input<T = any>(key: string, defaultValue?: T): T
   all: () => TFields
   only: <K extends keyof TFields & string>(keys: K[]) => Pick<TFields, K>
   except: <K extends keyof TFields & string>(keys: K[]) => Omit<TFields, K>
-  has: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
-  hasAny: (keys: (keyof TFields & string)[]) => boolean
-  filled: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
-  missing: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
+  has: (key: string | string[]) => boolean
+  hasAny: (keys: string[]) => boolean
+  filled: (key: string | string[]) => boolean
+  missing: (key: string | string[]) => boolean
   merge: (data: Partial<TFields>) => void
   keys: () => (keyof TFields & string)[]
   string: (key: keyof TFields & string, defaultValue?: string) => string
@@ -96,7 +97,7 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   date: (key: keyof TFields & string, format?: string) => Date | null
   enum: <T extends Record<string, string | number>>(key: keyof TFields & string, enumType: T) => T[keyof T] | null
   collect: <T = unknown>(key: keyof TFields & string) => Collection<T>
-  validate: (rules?: Record<string, string>, messages?: Record<string, string>) => Promise<TFields>
+  validate: (rules?: RequestValidationRules, messages?: Record<string, string>) => Promise<TFields>
   getValidated: () => TFields
   safe: () => SafeData<TFields>
   whenHas: <T>(key: keyof TFields & string, callback: (value: T) => void, defaultCallback?: () => void) => void
@@ -128,7 +129,10 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   getMethod: () => HttpMethod
   user: () => Promise<UserJsonResponse | undefined>
 }
-declare type UserJsonResponse = ModelRow<typeof User>;
+// Trait methods are attached dynamically by the Stacks model proxy. The
+// open member bag reflects application-level traits that the framework's
+// default User definition cannot know about ahead of time.
+declare type UserJsonResponse = NonNullable<Awaited<ReturnType<typeof User.find>>> & Record<string, any>;
 /**
  * Loose route-param shape kept around for back-compat with code that
  * predates {@link RequestInstance}'s `TParams` generic. New code should
@@ -255,3 +259,7 @@ export type ActionRequest<TFields extends Record<string, any> = Record<string, a
 export type InferValidations<V extends Record<string, { rule: any }>> = {
   [K in keyof V]: Infer<V[K]['rule']>
 }
+export type RequestValidationRules = Record<string, string | {
+  rule: { validate: (value: any) => any }
+  message?: string | Record<string, string>
+}>;

package/dist/search-engine.d.ts

@@ -1,4 +1,4 @@
-import type { Dictionary, DocumentOptions, EnqueuedTask, Faceting, Hits, Index, IndexesResults, IndexOptions, MeiliSearch, Settings as MeilisearchOptions, PaginationSettings, DocumentOptions as RecordOptions, SearchParams, SearchResponse, Settings, Synonyms, TypoTolerance } from 'meilisearch';
+import type { Dictionary, DocumentOptions, EnqueuedTask, Faceting, Hits, Index, IndexesResults, IndexOptions, Meilisearch, Settings as MeilisearchOptions, PaginationSettings, DocumentOptions as RecordOptions, SearchParams, SearchResponse, Settings, Synonyms, TypoTolerance } from 'meilisearch';
 import type { MaybePromise } from '.';
 export type {
   EnqueuedTask,
@@ -6,7 +6,7 @@ export type {
   Index,
   IndexesResults,
   IndexOptions,
-  MeiliSearch,
+  Meilisearch,
   MeilisearchOptions,
   RecordOptions,
   SearchParams,
@@ -55,7 +55,7 @@ export declare interface SearchEngineOptions {
   perPage?: number
 }
 export declare interface SearchEngineDriver {
-  client: () => MeiliSearch
+  client: () => Meilisearch
   resetClient?: () => void
   search: (index: string, params: any) => Promise<SearchResponse<Record<string, any>>>
   createIndex: (name: string, options?: IndexOptions) => MaybePromise<EnqueuedTask>

package/dist/storage.d.ts

@@ -1,5 +1,4 @@
 import type { Buffer } from 'node:buffer';
-import type { ReadableStream } from 'node:stream/web';
 /**
  * File stat entry information
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.70.73",
+  "version": "0.70.74",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -52,14 +52,16 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/bunpress": "^0.1.11",
+    "@stacksjs/bunpress": "^0.1.12",
+    "@stacksjs/clapp": "^0.2.10",
     "@stacksjs/ts-validation": "^0.5.0",
-    "bun-query-builder": "^0.1.38"
+    "bun-query-builder": "^0.1.47",
+    "meilisearch": "^0.59.0"
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.70.73",
+    "@stacksjs/validation": "0.70.74",
     "@types/bun": "^1.3.11",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   },
   "sideEffects": false
 }

package/src/cli.ts

@@ -442,4 +442,4 @@ export interface TypesOptions extends CliOptions {}
 
 export type LibEntryType = 'web-components' | 'functions' | 'all'
 
-export type { CAC as CLI } from 'cac'
+export type { CLI } from '@stacksjs/clapp'

package/src/email.ts

@@ -302,7 +302,7 @@ export interface EmailOptions {
   server: EmailServerConfig
   notifications?: EmailNotificationsConfig
 
-  default: 'log' | 'ses' | 'sendgrid' | 'mailgun' | 'mailtrap' | 'smtp'
+  default: 'log' | 'capture' | 'ses' | 'sendgrid' | 'mailgun' | 'mailtrap' | 'smtp'
 
   /**
    * Suppression-list enforcement policy (stacksjs/stacks#1880).

package/src/model.ts

@@ -252,6 +252,8 @@ export interface ModelOptions extends Base {
 }
 
 export interface Attribute {
+  type?: string
+  nullable?: boolean
   default?: string | number | boolean | Date
   unique?: boolean
   order?: number

package/src/phone.ts

@@ -48,6 +48,21 @@ export interface PhoneNotificationsConfig {
   voicemail?: PhoneNotificationConfig
 }
 
+export type CallForwardingCondition = 'always' | 'business_hours' | 'after_hours'
+
+export interface CallForwardingRule {
+  name: string
+  condition: CallForwardingCondition
+  forwardTo: string
+  ringTimeout: number
+  priority: number
+}
+
+export interface CallForwardingConfig {
+  enabled: boolean
+  rules: CallForwardingRule[]
+}
+
 export interface PhoneOptions {
   enabled: boolean
   provider: 'connect' // Amazon Connect
@@ -56,6 +71,7 @@ export interface PhoneOptions {
   phoneNumbers: PhoneNumberConfig[]
   notifications: PhoneNotificationsConfig
   voicemail: VoicemailConfig
+  forwarding?: CallForwardingConfig
   businessHours?: BusinessHoursConfig
 }
 

package/src/request.ts

@@ -1,4 +1,3 @@
-import type { ModelRow } from '@stacksjs/orm'
 import { User } from '@stacksjs/orm'
 import type { UploadedFile } from '@stacksjs/storage'
 import type { AuthToken, RouteParam } from '@stacksjs/types'
@@ -7,7 +6,10 @@ import type { AuthToken, RouteParam } from '@stacksjs/types'
 // keeps this package free of a runtime ts-validation dependency.
 import type { Infer } from '@stacksjs/ts-validation'
 
-type UserJsonResponse = ModelRow<typeof User>
+// Trait methods are attached dynamically by the Stacks model proxy. The
+// open member bag reflects application-level traits that the framework's
+// default User definition cannot know about ahead of time.
+type UserJsonResponse = NonNullable<Awaited<ReturnType<typeof User.find>>> & Record<string, any>
 
 interface RequestData {
   [key: string]: any
@@ -218,6 +220,11 @@ export type InferValidations<V extends Record<string, { rule: any }>> = {
   [K in keyof V]: Infer<V[K]['rule']>
 }
 
+export type RequestValidationRules = Record<string, string | {
+  rule: { validate: (value: any) => any }
+  message?: string | Record<string, string>
+}>
+
 export interface RequestInstance<
   TFields extends Record<string, any> = Record<string, any>,
   TParams extends Record<string, string> = Record<string, string>,
@@ -267,12 +274,14 @@ export interface RequestInstance<
    * @example request.get('title')           // returns string (when model-aware)
    * @example request.get('views', 0)        // returns number with default
    */
-  get: <K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]) => TFields[K]
+  get<K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]): TFields[K]
+  get<T = any>(key: string, defaultValue?: T): T
 
   /**
    * Alias for get() - Laravel compatibility
    */
-  input: <K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]) => TFields[K]
+  input<K extends keyof TFields & string>(key: K, defaultValue?: TFields[K]): TFields[K]
+  input<T = any>(key: string, defaultValue?: T): T
 
   /**
    * Get all input data (typed to model fields when model-aware)
@@ -296,25 +305,25 @@ export interface RequestInstance<
    * @example request.has('title')
    * @example request.has(['title', 'views'])
    */
-  has: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
+  has: (key: string | string[]) => boolean
 
   /**
    * Check if input has any of the specified keys
    * @example request.hasAny(['title', 'views'])
    */
-  hasAny: (keys: (keyof TFields & string)[]) => boolean
+  hasAny: (keys: string[]) => boolean
 
   /**
    * Check if input is filled (present and not empty)
    * @example request.filled('title')
    */
-  filled: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
+  filled: (key: string | string[]) => boolean
 
   /**
    * Check if input is missing
    * @example request.missing('title')
    */
-  missing: (key: (keyof TFields & string) | (keyof TFields & string)[]) => boolean
+  missing: (key: string | string[]) => boolean
 
   /**
    * Merge additional data into input — accepts partial model fields
@@ -390,7 +399,7 @@ export interface RequestInstance<
    * @example await request.validate()                    // uses model rules
    * @example await request.validate({ name: 'required' }) // custom rules
    */
-  validate: (rules?: Record<string, string>, messages?: Record<string, string>) => Promise<TFields>
+  validate: (rules?: RequestValidationRules, messages?: Record<string, string>) => Promise<TFields>
 
   /**
    * Get previously validated data, typed to model fields

package/src/search-engine.ts

@@ -7,7 +7,7 @@ import type {
   Index,
   IndexesResults,
   IndexOptions,
-  MeiliSearch,
+  Meilisearch,
   Settings as MeilisearchOptions,
   PaginationSettings,
   DocumentOptions as RecordOptions,
@@ -85,7 +85,7 @@ export interface SearchEngineOptions {
 export type SearchEngineConfig = Partial<SearchEngineOptions>
 
 export interface SearchEngineDriver {
-  client: () => MeiliSearch
+  client: () => Meilisearch
   resetClient?: () => void
 
   search: (index: string, params: any) => Promise<SearchResponse<Record<string, any>>>
@@ -243,7 +243,7 @@ export type {
   Index,
   IndexesResults,
   IndexOptions,
-  MeiliSearch,
+  Meilisearch,
   MeilisearchOptions,
   RecordOptions,
   SearchParams,

package/src/storage.ts

@@ -1,5 +1,4 @@
 import type { Buffer } from 'node:buffer'
-import type { ReadableStream } from 'node:stream/web'
 
 /**
  * File contents can be a string, Buffer, Uint8Array, or ReadableStream