@stacksjs/types 0.70.162 → 0.70.164

package/README.md

@@ -50,7 +50,7 @@ For help, discussion about best practices, or any other conversation that would
 
 For casual chit-chat with others using this package:
 
-[Join the Stacks Discord Server](https://discord.gg/stacksjs)
+[Join the Stacks Discord Server](https://stacksjs.com/discord)
 
 ## 📄 License
 

package/dist/ai.d.ts

@@ -6,9 +6,29 @@
  * have any questions, feel free to reach out via Discord or GitHub Discussions.
  */
 export declare interface AiOptions {
-  default: AiModel
+  default: 'anthropic' | 'openai' | 'ollama' | AiModel
   models: AiModel[]
   deploy: boolean
+  drivers?: {
+    anthropic?: {
+      apiKey?: string
+      model?: string
+      maxTokens?: number
+      anthropicVersion?: string
+    }
+    openai?: {
+      apiKey?: string
+      model?: string
+      maxTokens?: number
+      baseUrl?: string
+      embeddingModel?: string
+    }
+    ollama?: {
+      host?: string
+      model?: string
+      embeddingModel?: string
+    }
+  }
 }
 declare type AiModel = | 'amazon.titan-embed-text-v1'
   | 'amazon.titan-embed-text-v2:0'

package/dist/cloud.d.ts

@@ -22,6 +22,7 @@ export declare interface CloudOptions {
     path: string
     [site: string]: string | SiteConfig
   }
+  tenants: string[]
   infrastructure: InfrastructureOptions
   cdn: any
   api: any

package/dist/email.d.ts

@@ -25,7 +25,6 @@ export declare interface EmailFilterRule {
 }
 export declare interface MailboxConfig {
   email?: string
-  address?: string
   displayName?: string
   password?: string
   forwardTo?: string[]
@@ -46,7 +45,6 @@ export declare interface MailServerPortsConfig {
   imaps?: number
   pop3?: number
   pop3s?: number
-  smtpStartTls?: number
 }
 export declare interface MailServerFeaturesConfig {
   imap?: boolean

package/dist/model.d.ts

@@ -166,7 +166,7 @@ export declare interface ModelOptions extends Base {
     softDeletable?: boolean | SoftDeleteOptions
     categorizable?: boolean
     taggable?: boolean
-    commentables?: boolean
+    commentable?: boolean
     useAuth?: boolean | UserAuthOptions
     authenticatable?: boolean | UserAuthOptions
     useSeeder?: boolean | SeedOptions

package/dist/request.d.ts

@@ -113,7 +113,7 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
     key: K,
     defaultValue?: D,
   ) => K extends keyof TParams ? TParams[K] : (string | D)
-  getParam: <K extends string>(key: K) => K extends NumericField ? number : string
+  getParam: (key: string) => string
   route: (key: string) => number | string | null
   getParams: () => TParams
   getParamAsInt: (key: string) => number | null
@@ -133,30 +133,6 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
 // 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
- * rely on the path-extracted `TParams` instead — see {@link ExtractParams}.
- *
- * @deprecated Use {@link ExtractParams}-driven typing on the action /
- *   route signature instead. URL route params are always strings at
- *   runtime; the `string | number` here misled callers into thinking
- *   the framework coerced numbers automatically (it doesn't —
- *   `Number(request.params.id)` is the correct pattern).
- */
-declare type RouteParams = { [key: string]: string | number } | null;
-/**
- * Legacy hard-coded list of param names treated as `number` by
- * {@link RequestInstance.getParam}. The name-match heuristic is
- * brittle (`'judgeId'`, `'user_id'`, etc. all silently fall through
- * to `string`) and will be retired in a future release.
- *
- * @deprecated The name-match returns `number` for these specific keys
- *   only — pass the value through {@link Number} or
- *   {@link RequestInstance.getParamAsInt} for explicit, predictable
- *   coercion. See stacksjs/stacks#1851 Phase 3.
- */
-declare type NumericField = 'id' | 'age' | 'count' | 'quantity' | 'amount' | 'price' | 'total' | 'score' | 'rating' | 'duration' | 'size' | 'weight' | 'height' | 'width' | 'length' | 'distance' | 'speed' | 'temperature' | 'volume' | 'capacity' | 'density' | 'pressure' | 'force' | 'energy' | 'power' | 'frequency' | 'voltage' | 'current' | 'resistance' | 'time' | 'date' | 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond' | 'microsecond' | 'nanosecond';
 /**
  * Template-literal helper that extracts named route params from a
  * path string (stacksjs/stacks#1851 Phase 2a). Supports both Stacks's

package/dist/router.d.ts

@@ -11,7 +11,11 @@ export declare interface ValidationField {
 export declare interface CustomAttributes {
   [key: string]: ValidationField
 }
-export declare interface RouteParams { [key: string]: string | number }
+/**
+ * URL route parameters. Always strings at runtime - the router does no
+ * coercion. Use `Number(...)` or `getParamAsInt()` when you want a number.
+ */
+export declare interface RouteParams { [key: string]: string }
 export declare interface Route {
   name: string
   uri: string
@@ -75,7 +79,7 @@ export declare interface RouterInstance {
   addBodies: (params: any) => void
   addParam: (param: RouteParam) => void
   addHeaders: (headerParams: Headers) => void
-  get: <K extends string>(element: K, defaultValue?: K extends NumericField ? number : string) => K extends NumericField ? number : string
+  get: (element: string, defaultValue?: string) => string
   all: () => any
   validate: (attributes?: CustomAttributes) => Promise<void>
   has: (element: string) => boolean
@@ -84,7 +88,7 @@ export declare interface RouterInstance {
   header: (headerParam: string) => string | number | boolean | null
   getHeaders: () => any
   Header: (headerParam: string) => string | number | boolean | null
-  getParam: <T>(key: string) => T
+  getParam: (key: string) => string
   route: (key: string) => number | string | null
   bearerToken: () => string | null | RouterAuthToken
   getParams: () => RouteParams
@@ -98,7 +102,6 @@ declare type ActionPath = string;
 // need to refactor before, after, view to be a part of some other type
 export type RouteCallback = ((_params?: Record<string, any>) => any | string | object) | ((req: any, res: any) => Promise<void>);
 export type RouterAuthToken = `${number}:${number}:${string}`;
-export type NumericField = 'id' | 'age' | 'count' | 'quantity' | 'amount' | 'price' | 'total' | 'score' | 'rating' | 'duration' | 'size' | 'weight' | 'height' | 'width' | 'length' | 'distance' | 'speed' | 'temperature' | 'volume' | 'capacity' | 'density' | 'pressure' | 'force' | 'energy' | 'power' | 'frequency' | 'voltage' | 'current' | 'resistance' | 'time' | 'date' | 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond' | 'microsecond' | 'nanosecond';
 export type StatusCode = 200 | 201 | 202 | 204 | 301 | 302 | 304 | 400 | 401 | 403 | 404 | 500;
 export type RedirectCode = Extract<StatusCode, 301 | 302>;
 export type MiddlewareFn = (_request: Request) => Promise<void>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.70.162",
+  "version": "0.70.164",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -53,7 +53,7 @@
   "dependencies": {
     "@stacksjs/bunpress": "^0.1.18",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/stx": "^0.2.99",
+    "@stacksjs/stx": "^0.2.100",
     "@stacksjs/ts-validation": "^0.5.0",
     "bun-query-builder": "^0.1.56"
   },
@@ -66,7 +66,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.70.162",
+    "@stacksjs/validation": "0.70.164",
     "@types/bun": "^1.3.11",
     "meilisearch": "^0.59.0",
     "typescript": "^7.0.2"