@stacksjs/types 0.70.45 → 0.70.53

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2023 Open Web Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/auth.d.ts

@@ -1,4 +1,6 @@
 export declare interface AuthOptions {
+  enabled?: boolean
+  env?: string[]
   default: string
   guards: {
     [key: string]: {
@@ -22,6 +24,11 @@ export declare interface AuthOptions {
   passwordReset: {
     expire: number
     throttle: number
+    url?: string
+  }
+  emailVerification?: {
+    expire?: number
+    url?: string
   }
 }
 export declare interface AuthInstance {

package/dist/cache.d.ts

@@ -2,7 +2,7 @@
  * Cache Options - Configuration for the caching system
  */
 export declare interface CacheOptions {
-  driver: 'memory' | 'redis'
+  driver: 'memory' | 'redis' | 'singlestore'
   prefix: string
   ttl: number
   maxKeys?: number
@@ -22,6 +22,15 @@ export declare interface CacheOptions {
       checkPeriod?: number
       deleteOnExpire?: boolean
     }
+    singlestore?: {
+      host?: string
+      port?: number
+      username?: string
+      password?: string
+      database?: string
+      table?: string
+      ssl?: boolean
+    }
   }
 }
 /**

package/dist/cli.d.ts

@@ -194,7 +194,8 @@ export type CreateBooleanOption = | 'ui'
   | 'views'
   | 'functions'
   | 'api'
-  | 'database';
+  | 'database'
+  | 'minimal';
 export type CreateOptions = {
   [key in CreateBooleanOption]: boolean
 } & {

package/dist/cms.d.ts

@@ -0,0 +1,12 @@
+/**
+ * **CMS Options**
+ *
+ * Top-level feature gate plus any future CMS-wide settings. The CMS bundle
+ * (Post / Page / Author / Comment / Tag / Category models + edit dashboards)
+ * stays inert at boot when `enabled` is `false`.
+ */
+export declare interface CmsOptions {
+  enabled?: boolean
+  env?: string[]
+}
+export type CmsConfig = Partial<CmsOptions>;

package/dist/commerce.d.ts

@@ -0,0 +1,14 @@
+/**
+ * **Commerce Options**
+ *
+ * Top-level feature gate plus storefront defaults. The commerce bundle
+ * (Order / Cart / Product / Customer / Coupon / GiftCard / Shipping models +
+ * storefront API) stays inert at boot when `enabled` is `false`.
+ */
+export declare interface CommerceOptions {
+  enabled?: boolean
+  env?: string[]
+  currency?: string
+  defaultTaxRate?: number
+}
+export type CommerceConfig = Partial<CommerceOptions>;

package/dist/cors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CORS configuration types (stacksjs/stacks#1859 H-2).
+ *
+ * Lives in `@stacksjs/types` so userland `config/cors.ts` files can
+ * `import type { CorsConfig } from '@stacksjs/types'` and get full
+ * IntelliSense, and so the Cors middleware can read
+ * `config.cors` with proper typing instead of an `as any` cast.
+ */
+/**
+ * Raw CORS configuration — every field optional. Defaults fill in
+ * any field that's missing when the middleware resolves config.
+ *
+ * @example
+ * ```ts
+ * // config/cors.ts
+ * import type { CorsConfig } from '@stacksjs/types'
+ *
+ * export default {
+ *   origin: ['https://app.example.com', 'https://admin.example.com'],
+ *   credentials: true,
+ *   methods: ['GET', 'POST', 'PUT', 'DELETE'],
+ *   allowedHeaders: ['Content-Type', 'Authorization', 'X-CSRF-Token'],
+ *   maxAge: 600,
+ * } satisfies CorsConfig
+ * ```
+ */
+export declare interface CorsConfig {
+  origin?: '*' | string[] | ((origin: string) => boolean)
+  methods?: string[]
+  allowedHeaders?: string[]
+  exposedHeaders?: string[]
+  credentials?: boolean
+  maxAge?: number
+}
+/**
+ * Resolved CORS configuration with all defaults applied. This is the
+ * shape the middleware passes through `applyCorsHeaders` /
+ * `buildPreflightResponse`.
+ */
+export declare interface ResolvedCorsConfig {
+  origin: '*' | string[] | ((origin: string) => boolean)
+  methods: string[]
+  allowedHeaders: string[]
+  exposedHeaders: string[]
+  credentials: boolean
+  maxAge: number
+}

package/dist/dashboard.d.ts

@@ -12,6 +12,8 @@
  * row when there's no newsletter without losing the model viewer.
  */
 export declare interface DashboardOptions {
+  enabled?: boolean
+  env?: string[]
   sections?: {
     library?: { enabled?: boolean }
     content?: { enabled?: boolean }
@@ -29,5 +31,78 @@ export declare interface DashboardOptions {
       allModels?: { enabled?: boolean }
     }
   }
+  ci?: {
+    enabled?: boolean
+    orgs?: string[]
+    runnerCaps?: Record<string, number>
+    runnerCapDefault?: number
+    ignoreRepos?: string[]
+    notifications?: {
+      enabled?: boolean
+      channels?: Array<'email' | 'sms' | 'chat' | 'database'>
+      recipients?: Array<{ email?: string, phone?: string, userId?: number }>
+      cooldownMinutes?: number
+    }
+    alerts?: {
+      enabled?: boolean
+      queuedThreshold?: number
+      windowMinutes?: number
+      channels?: Array<'email' | 'sms' | 'chat' | 'database'>
+      recipients?: Array<{ email?: string, phone?: string, userId?: number }>
+      retentionHours?: number
+    }
+  }
+}
+/**
+ * Per-model dashboard configuration (stacksjs/stacks#1843).
+ *
+ * Attach to a model definition to influence how the model surfaces in the
+ * dashboard sidebar without touching the framework's dashboard internals:
+ *
+ * ```ts
+ * defineModel({
+ *   name: 'AuditLog',
+ *   table: 'audit_logs',
+ *   dashboard: {
+ *     section: 'management',
+ *     icon: 'shield',
+ *     roles: ['admin'],
+ *     description: 'Append-only audit trail (admin-only)',
+ *   },
+ *   attributes: { … },
+ * })
+ * ```
+ *
+ * Resolution chain (most specific → fallback):
+ *
+ *   1. `dashboard.enabled === false` → model is hidden from the sidebar
+ *      entirely. The dynamic ORM viewer (`/models/<id>`) still works for
+ *      direct navigation, but the row is suppressed.
+ *   2. `dashboard.section` → pins the model to that section, overriding
+ *      the path-based auto-categorisation (commerce/, Content/, etc.).
+ *   3. `dashboard.label` / `dashboard.icon` → display overrides; fall back
+ *      to the model name and `iconMap` lookup.
+ *   4. `dashboard.roles` → role-gates the sidebar row. The server-side
+ *      sidebar builder emits the row with role metadata; the client filters
+ *      it out for users who lack a matching role. Permissive default
+ *      (unauthenticated viewers see everything — see `useRole.ts`).
+ */
+export declare interface DashboardModelOptions {
+  enabled?: boolean
+  label?: string
+  icon?: string
+  section?:
+    | 'home'
+    | 'library'
+    | 'content'
+    | 'commerce'
+    | 'marketing'
+    | 'analytics'
+    | 'management'
+    | 'utilities'
+    | 'data'
+    | 'app'
+  roles?: string[]
+  description?: string
 }
 export type DashboardConfig = Partial<DashboardOptions>;

package/dist/database.d.ts

@@ -12,6 +12,16 @@ export declare interface DatabaseOptions {
       password?: string
       prefix?: string
     }
+    singlestore?: {
+      url?: string
+      host?: string
+      port?: number
+      name?: string
+      username?: string
+      password?: string
+      prefix?: string
+      ssl?: boolean
+    }
     sqlite: {
       url?: string
       database?: string

package/dist/email.d.ts

@@ -102,12 +102,15 @@ export declare interface EmailOptions {
     address: string
   }
   mailboxes: string[] | MailboxConfig[]
+  forwards?: Record<string, string[]>
   domain?: string
   url: string
   charset: string
   server: EmailServerConfig
   notifications?: EmailNotificationsConfig
   default: 'log' | 'ses' | 'sendgrid' | 'mailgun' | 'mailtrap' | 'smtp'
+  suppressionPolicy?: 'strict' | 'transactional-allowed' | 'off'
+  unsubscribeRoute?: string
 }
 export declare interface MailtrapConfig extends EmailDriverConfig {
   token: string
@@ -142,6 +145,7 @@ export declare interface EmailMessage {
   to: string | string[] | EmailAddress[]
   cc?: string | string[] | EmailAddress[]
   bcc?: string | string[] | EmailAddress[]
+  replyTo?: EmailAddress | EmailAddress[] | string | string[]
   subject: string
   template?: string
   html?: string
@@ -151,6 +155,8 @@ export declare interface EmailMessage {
   onSuccess?: () => Promise<{ message: string }> | { message: string }
   onError?: (error: Error) => Promise<{ message: string }> | { message: string }
   handle?: () => Promise<{ message: string }> | { message: string }
+  idempotencyKey?: string
+  tag?: 'transactional' | 'broadcast'
 }
 // Email interfaces
 export declare interface EmailAddress {

package/dist/index.d.ts

@@ -15,10 +15,17 @@ export * from './cdn';
 export * from './chat';
 export * from './cli';
 export * from './cloud';
+export * from './cms';
+export * from './commerce';
 export * from './components';
 export * from './configure';
+export * from './cors';
 export * from './cron-jobs';
 export * from './dashboard';
+// Module-augments bun-query-builder's BrowserModelDefinition with the
+// stacks `dashboard` slot. Importing this file (transitively via the
+// barrel) is what makes `defineModel({ dashboard: {...} })` typecheck.
+export * from './model-dashboard-augmentation';
 export * from './database';
 export * from './dependencies';
 export * from './deploy';
@@ -37,8 +44,10 @@ export * from './i18n';
 export * from './library';
 export * from './logging';
 export * from './manifest';
+export * from './marketing';
 export * from './model';
 export * from './model-names';
+export * from './monitoring';
 export * from './notifications';
 export * from './pages';
 export * from './payments';

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-function f(D){return typeof D==="object"&&D!==null&&"id"in D&&"userId"in D&&"clientId"in D&&"scopes"in D}function G(D){return f(D)&&"abilities"in D}function H(D){return typeof D==="object"&&D!==null&&"id"in D&&"name"in D&&"secret"in D&&"redirect"in D}var x;((p)=>{p.Second="* * * * * *";p.FiveSeconds="*/5 * * * * *";p.TenSeconds="*/10 * * * * *";p.ThirtySeconds="*/30 * * * * *";p.Minute="* * * * *";p.TwoMinutes="*/2 * * * *";p.FiveMinutes="*/5 * * * *";p.TenMinutes="*/10 * * * *";p.FifteenMinutes="*/15 * * * *";p.ThirtyMinutes="*/30 * * * *";p.Hour="0 * * * *";p.HalfHour="0,30 * * * *";p.Day="0 0 * * *";p.Week="0 0 * * 0";p.Weekday="0 0 * * 1-5";p.Weekend="0 0 * * 0,6";p.Month="0 0 1 * *";p.Year="0 0 1 1 *"})(x||={});var F;((B)=>{B.Bluesky="bluesky";B.Discord="discord";B.Facebook="facebook";B.GitHub="github";B.Instagram="instagram";B.LinkedIn="linkedin";B.Mastodon="mastodon";B.Slack="slack";B.Twitter="twitter";B.YouTube="youtube"})(F||={});var U;((O)=>{O[O.Success=0]="Success";O[O.FatalError=1]="FatalError";O[O.InvalidArgument=9]="InvalidArgument"})(U||={});import{toString as _}from"@stacksjs/strings";function J(D){if(D===null)return"null";let P=_(D).slice(8,-1).toLowerCase();return typeof D==="object"||typeof D==="function"?P:typeof D}function Q(D){return D}function R(D){return D}var W={development:{default:"sync",connections:{sync:{driver:"sync"}},failed:{driver:"database",table:"failed_jobs"}},production:{default:"redis",connections:{redis:{driver:"redis",prefix:"stacks:queue",concurrency:5,distributedLock:!0,metrics:{enabled:!0},defaultDeadLetterOptions:{enabled:!0,maxRetries:3}}},failed:{driver:"redis",prefix:"stacks:failed"},worker:{concurrency:5,shutdownTimeout:30000}},highPerformance:{default:"redis",connections:{redis:{driver:"redis",prefix:"stacks:queue",concurrency:20,distributedLock:!0,metrics:{enabled:!0,collectInterval:5000},horizontalScaling:{enabled:!0,maxWorkersPerInstance:20,jobsPerWorker:50},defaultDeadLetterOptions:{enabled:!0,maxRetries:5}}},failed:{driver:"redis",prefix:"stacks:failed"},worker:{concurrency:20,shutdownTimeout:60000}},database:{default:"database",connections:{database:{driver:"database",table:"jobs",queue:"default",retryAfter:90}},failed:{driver:"database",table:"failed_jobs"}}};var Z={server:{development:{enabled:!0,mode:"server",debug:!0,server:{host:"localhost",port:6001,scheme:"ws",driver:"bun",rateLimit:{enabled:!1},healthCheck:{enabled:!0,path:"/health"}},channels:{public:!0,private:!0,presence:!0}},production:{enabled:!0,mode:"server",debug:!1,server:{host:"0.0.0.0",port:6001,scheme:"wss",driver:"bun",redis:{enabled:!0,prefix:"stacks:realtime:"},rateLimit:{enabled:!0,maxConnectionsPerIp:100,maxMessagesPerSecond:50,maxPayloadSize:65536},loadManagement:{maxConnections:1e4,backpressureThreshold:1000,messageQueueSize:1e4,gracefulShutdownTimeout:30000},autoScaling:{min:2,max:10,targetCPU:70},healthCheck:{enabled:!0,path:"/health",interval:30},metrics:{enabled:!0,port:9090,path:"/metrics"}},channels:{public:!0,private:!0,presence:!0}},highPerformance:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0,cluster:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:500,maxMessagesPerSecond:200,maxPayloadSize:131072},loadManagement:{maxConnections:1e5,backpressureThreshold:5000,messageQueueSize:50000,gracefulShutdownTimeout:60000},autoScaling:{min:4,max:50,targetCPU:60}}},chat:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:10,maxMessagesPerSecond:20},loadManagement:{maxConnections:50000}},channels:{public:!0,private:!0,presence:{enabled:!0,maxMembersPerChannel:500,memberInfoTtl:60}}},gaming:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0,cluster:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:50,maxMessagesPerSecond:100},loadManagement:{maxConnections:50000,backpressureThreshold:2000,messageQueueSize:20000},autoScaling:{min:2,max:20,targetCPU:50}},channels:{public:!0,private:!0,presence:!0}}},serverless:{development:{enabled:!0,mode:"serverless",debug:!0,serverless:{connectionTimeout:3600,idleTimeout:600,stageName:"dev",memorySize:256,timeout:30},channels:{public:!0,private:!0,presence:!0}},production:{enabled:!0,mode:"serverless",debug:!1,serverless:{connectionTimeout:3600,idleTimeout:600,stageName:"production",memorySize:512,timeout:30,provisionedConcurrency:2},channels:{public:!0,private:!0,presence:!0}},notifications:{enabled:!0,mode:"serverless",serverless:{connectionTimeout:7200,idleTimeout:1800,memorySize:256,timeout:15},channels:{public:!0,private:!0,presence:!1}}}};var w={};export{w as stackExtensionRegistry,G as isPersonalAccessToken,H as isOAuthClient,f as isAccessToken,J as getTypeName,R as defineModels,Q as defineModel,F as SocialLinkIcon,Z as RealtimePresets,W as QueuePresets,U as ExitCode,x as Every};
+function x(p){return typeof p==="object"&&p!==null&&"id"in p&&"userId"in p&&"clientId"in p&&"scopes"in p}function G(p){return x(p)&&"abilities"in p}function H(p){return typeof p==="object"&&p!==null&&"id"in p&&"name"in p&&"secret"in p&&"redirect"in p}var F;((D)=>{D.Second="* * * * * *";D.FiveSeconds="*/5 * * * * *";D.TenSeconds="*/10 * * * * *";D.ThirtySeconds="*/30 * * * * *";D.Minute="* * * * *";D.TwoMinutes="*/2 * * * *";D.FiveMinutes="*/5 * * * *";D.TenMinutes="*/10 * * * *";D.FifteenMinutes="*/15 * * * *";D.ThirtyMinutes="*/30 * * * *";D.Hour="0 * * * *";D.HalfHour="0,30 * * * *";D.Day="0 0 * * *";D.Week="0 0 * * 0";D.Weekday="0 0 * * 1-5";D.Weekend="0 0 * * 0,6";D.Month="0 0 1 * *";D.Year="0 0 1 1 *"})(F||={});var U;((B)=>{B.Bluesky="bluesky";B.Discord="discord";B.Facebook="facebook";B.GitHub="github";B.Instagram="instagram";B.LinkedIn="linkedin";B.Mastodon="mastodon";B.Slack="slack";B.Twitter="twitter";B.YouTube="youtube"})(U||={});var _;((O)=>{O[O.Success=0]="Success";O[O.FatalError=1]="FatalError";O[O.InvalidArgument=9]="InvalidArgument"})(_||={});import{toString as f}from"@stacksjs/strings";function J(p){if(p===null)return"null";let P=f(p).slice(8,-1).toLowerCase();return typeof p==="object"||typeof p==="function"?P:typeof p}function M(p){return p}function Q(p){return p}var V={development:{default:"sync",connections:{sync:{driver:"sync"}},failed:{driver:"database",table:"failed_jobs"}},production:{default:"redis",connections:{redis:{driver:"redis",prefix:"stacks:queue",concurrency:5,distributedLock:!0,metrics:{enabled:!0},defaultDeadLetterOptions:{enabled:!0,maxRetries:3}}},failed:{driver:"redis",prefix:"stacks:failed"},worker:{concurrency:5,shutdownTimeout:30000}},highPerformance:{default:"redis",connections:{redis:{driver:"redis",prefix:"stacks:queue",concurrency:20,distributedLock:!0,metrics:{enabled:!0,collectInterval:5000},horizontalScaling:{enabled:!0,maxWorkersPerInstance:20,jobsPerWorker:50},defaultDeadLetterOptions:{enabled:!0,maxRetries:5}}},failed:{driver:"redis",prefix:"stacks:failed"},worker:{concurrency:20,shutdownTimeout:60000}},database:{default:"database",connections:{database:{driver:"database",table:"jobs",queue:"default",retryAfter:90}},failed:{driver:"database",table:"failed_jobs"}}};var X={server:{development:{enabled:!0,mode:"server",debug:!0,server:{host:"localhost",port:6001,scheme:"ws",driver:"bun",rateLimit:{enabled:!1},healthCheck:{enabled:!0,path:"/health"}},channels:{public:!0,private:!0,presence:!0}},production:{enabled:!0,mode:"server",debug:!1,server:{host:"0.0.0.0",port:6001,scheme:"wss",driver:"bun",redis:{enabled:!0,prefix:"stacks:realtime:"},rateLimit:{enabled:!0,maxConnectionsPerIp:100,maxMessagesPerSecond:50,maxPayloadSize:65536},loadManagement:{maxConnections:1e4,backpressureThreshold:1000,messageQueueSize:1e4,gracefulShutdownTimeout:30000},autoScaling:{min:2,max:10,targetCPU:70},healthCheck:{enabled:!0,path:"/health",interval:30},metrics:{enabled:!0,port:9090,path:"/metrics"}},channels:{public:!0,private:!0,presence:!0}},highPerformance:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0,cluster:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:500,maxMessagesPerSecond:200,maxPayloadSize:131072},loadManagement:{maxConnections:1e5,backpressureThreshold:5000,messageQueueSize:50000,gracefulShutdownTimeout:60000},autoScaling:{min:4,max:50,targetCPU:60}}},chat:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:10,maxMessagesPerSecond:20},loadManagement:{maxConnections:50000}},channels:{public:!0,private:!0,presence:{enabled:!0,maxMembersPerChannel:500,memberInfoTtl:60}}},gaming:{enabled:!0,mode:"server",server:{driver:"bun",redis:{enabled:!0,cluster:!0},rateLimit:{enabled:!0,maxConnectionsPerIp:50,maxMessagesPerSecond:100},loadManagement:{maxConnections:50000,backpressureThreshold:2000,messageQueueSize:20000},autoScaling:{min:2,max:20,targetCPU:50}},channels:{public:!0,private:!0,presence:!0}}},serverless:{development:{enabled:!0,mode:"serverless",debug:!0,serverless:{connectionTimeout:3600,idleTimeout:600,stageName:"dev",memorySize:256,timeout:30},channels:{public:!0,private:!0,presence:!0}},production:{enabled:!0,mode:"serverless",debug:!1,serverless:{connectionTimeout:3600,idleTimeout:600,stageName:"production",memorySize:512,timeout:30,provisionedConcurrency:2},channels:{public:!0,private:!0,presence:!0}},notifications:{enabled:!0,mode:"serverless",serverless:{connectionTimeout:7200,idleTimeout:1800,memorySize:256,timeout:15},channels:{public:!0,private:!0,presence:!1}}}};var $={};export{$ as stackExtensionRegistry,G as isPersonalAccessToken,H as isOAuthClient,x as isAccessToken,J as getTypeName,Q as defineModels,M as defineModel,U as SocialLinkIcon,X as RealtimePresets,V as QueuePresets,_ as ExitCode,F as Every};

package/dist/logging.d.ts

@@ -8,5 +8,8 @@
 export declare interface LoggingOptions {
   logsPath: string
   deploymentsPath: string
+  level?: 'debug' | 'info' | 'success' | 'warning' | 'error'
+  format?: 'json' | 'text'
+  writeToFile?: boolean
 }
 export type LoggingConfig = Partial<LoggingOptions>;

package/dist/marketing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * **Marketing Options**
+ *
+ * Top-level feature gate for the marketing bundle (`/api/email/subscribe`,
+ * `/api/contact`, Campaign / EmailList / SocialPost). Stays inert at boot
+ * when `enabled` is `false`.
+ */
+export declare interface MarketingOptions {
+  enabled?: boolean
+  env?: string[]
+}
+export type MarketingConfig = Partial<MarketingOptions>;

package/dist/model-dashboard-augmentation.d.ts

@@ -0,0 +1,8 @@
+import type { DashboardModelOptions } from './dashboard';
+// Re-export for `import type { DashboardModelOptions } from '@stacksjs/types'`.
+export type { DashboardModelOptions };
+declare module 'bun-query-builder' {
+  interface BrowserModelDefinition {
+  readonly dashboard?: DashboardModelOptions
+}
+}

package/dist/model.d.ts

@@ -103,6 +103,7 @@ export declare interface LikeableOptions {
 }
 export declare interface SeedOptions {
   count: number
+  fixtures?: Array<Record<string, unknown>>
 }
 declare interface ActivityLogOption {
   exclude: LogAttribute[]
@@ -210,6 +211,8 @@ export declare interface Attribute {
 export declare interface CompositeIndex {
   name: string
   columns: string[]
+  unique?: boolean
+  where?: string
 }
 export declare interface AttributesElements {
   [key: string]: Attribute
@@ -241,7 +244,7 @@ declare type ActionPath = string;
 declare type ActionName = string;
 declare type Action = ActionPath | ActionName | undefined;
 export type ApiRoutes = 'index' | 'show' | 'store' | 'update' | 'destroy';
-export type SocialProviders = 'google' | 'github' | 'twitter' | 'facebook';
+export type SocialProviders = 'google' | 'github' | 'apple' | 'twitter' | 'facebook';
 declare type LogAttribute = string;
 export type SocialOptions = SocialProviders[];
 declare type ApiOptions = DeepPartial<ApiSettings>;

package/dist/monitoring.d.ts

@@ -0,0 +1,12 @@
+/**
+ * **Monitoring Options**
+ *
+ * Top-level feature gate for the monitoring bundle (Error model +
+ * error-tracking views and actions). Stays inert at boot when `enabled`
+ * is `false`.
+ */
+export declare interface MonitoringOptions {
+  enabled?: boolean
+  env?: string[]
+}
+export type MonitoringConfig = Partial<MonitoringOptions>;

package/dist/queue.d.ts

@@ -248,6 +248,8 @@ export declare interface Dispatchable {
   onQueue: (queue: string) => this
 }
 export declare interface QueueOptions {
+  enabled?: boolean
+  env?: string[]
   default: QueueDriver
   connections: {
     sync?: SyncConnectionConfig

package/dist/realtime.d.ts

@@ -9,7 +9,7 @@ export declare const RealtimePresets: {
   /**
      * Development preset - minimal config, debug enabled
      */
-    development: {
+  development: {
   enabled: true;
   mode: 'server';
   debug: true;
@@ -35,7 +35,7 @@ export declare const RealtimePresets: {
   /**
      * Production preset - optimized for production workloads
      */
-    production: {
+  production: {
   enabled: true;
   mode: 'server';
   debug: false;
@@ -85,7 +85,7 @@ export declare const RealtimePresets: {
   /**
      * High performance preset - optimized for high throughput
      */
-    highPerformance: {
+  highPerformance: {
   enabled: true;
   mode: 'server';
   server: {
@@ -116,7 +116,7 @@ export declare const RealtimePresets: {
   /**
      * Chat application preset
      */
-    chat: {
+  chat: {
   enabled: true;
   mode: 'server';
   server: {
@@ -146,7 +146,7 @@ export declare const RealtimePresets: {
   /**
      * Gaming preset - low latency, high throughput
      */
-    gaming: {
+  gaming: {
   enabled: true;
   mode: 'server';
   server: {
@@ -185,7 +185,7 @@ export declare const RealtimePresets: {
   /**
      * Development preset
      */
-    development: {
+  development: {
   enabled: true;
   mode: 'serverless';
   debug: true;
@@ -205,7 +205,7 @@ export declare const RealtimePresets: {
   /**
      * Production preset
      */
-    production: {
+  production: {
   enabled: true;
   mode: 'serverless';
   debug: false;
@@ -226,7 +226,7 @@ export declare const RealtimePresets: {
   /**
      * Notifications preset - simple push notifications
      */
-    notifications: {
+  notifications: {
   enabled: true;
   mode: 'serverless';
   serverless: {

package/dist/request.d.ts

@@ -1,10 +1,32 @@
 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
 }
+/**
+ * Cookie-access helper exposed via `request.cookies` on
+ * {@link RequestInstance}. The methods mirror bun-router's
+ * `CookieAccessor` — duplicated locally so this package doesn't
+ * have to depend on bun-router for a single type. Keep the surface
+ * in sync if bun-router extends its accessor.
+ */
+export declare interface RequestCookies {
+  get: (name: string) => string | undefined
+  set: (name: string, value: string, options?: {
+    path?: string
+    domain?: string
+    secure?: boolean
+    httpOnly?: boolean
+    sameSite?: 'strict' | 'lax' | 'none'
+    maxAge?: number
+    expires?: Date
+  }) => void
+  delete: (name: string, options?: { path?: string, domain?: string }) => void
+  getAll: () => Record<string, string>
+}
 /**
  * Collection interface for array data (Laravel-style)
  */
@@ -45,15 +67,16 @@ export declare interface SafeData<T extends Record<string, any> = Record<string,
   has: (key: keyof T) => boolean
   get: <K extends keyof T>(key: K) => T[K]
 }
-export declare interface RequestInstance<TFields extends Record<string, any> = Record<string, any>> {
+export declare interface RequestInstance<TFields extends Record<string, any> = Record<string, any>, TParams extends Record<string, string> = Record<string, string>,> {
   url: string
   method: string
   headers: Headers
   query: RequestData
-  params: RouteParams
+  params: TParams
   jsonBody?: any
   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]
   all: () => TFields
@@ -85,9 +108,13 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   allFiles: () => Record<string, UploadedFile | UploadedFile[]>
   header: (key: string) => string | null
   bearerToken: () => string | null | AuthToken
+  param: <K extends keyof TParams | string, D = string>(
+    key: K,
+    defaultValue?: D,
+  ) => K extends keyof TParams ? TParams[K] : (string | D)
   getParam: <K extends string>(key: K) => K extends NumericField ? number : string
   route: (key: string) => number | string | null
-  getParams: () => RouteParams
+  getParams: () => TParams
   getParamAsInt: (key: string) => number | null
   old: <T = unknown>(key: keyof TFields & string, defaultValue?: T) => T
   flashInput: (keys?: (keyof TFields & string)[]) => void
@@ -102,8 +129,65 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   user: () => Promise<UserJsonResponse | undefined>
 }
 declare type UserJsonResponse = ModelRow<typeof User>;
+/**
+ * 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
+ * brace-style (`/users/{id}`) and Express-style (`/users/:id`) so a
+ * project using either gets typed `params` out of the box.
+ *
+ * @example
+ *   ExtractParams<'/api/judges/{id}/follow'>  // { id: string }
+ *   ExtractParams<'/api/orders/:orderId/items/:itemId'>  // { orderId: string, itemId: string }
+ *   ExtractParams<'/api/health'>  // Record<string, never>
+ */
+// Step 1: pull the next param name out of either `{name}` or `:name`,
+// recurse on the rest, and union the keys.
+declare type ExtractParamKeys<S extends string> = S extends `${string}{${infer Key}}${infer Rest}`
+    ? Key | ExtractParamKeys<Rest>
+    // colon form: `…/:name/…` (colon must be at a segment boundary
+    // so we don't match `:` inside e.g. a port number; the `/` before
+    // it enforces that)
+    : S extends `${string}/:${infer Key}/${infer Rest}`
+      ? KeyHead<Key> | ExtractParamKeys<`/${Rest}`>
+      // tail colon-form: `…/:name` (no trailing slash)
+      : S extends `${string}/:${infer Key}`
+        ? KeyHead<Key>
+        : never;
+// `KeyHead<'name>'>` → `'name>'` because TS template literal infers
+// the longest possible match. We need to handle params that are at
+// the end of the path AND followed by a query string. This util
+// truncates a captured key at the first non-name character.
+declare type KeyHead<S extends string> = S extends `${infer H}/${string}` ? H :
+    S extends `${infer H}?${string}` ? H :
+      S extends `${infer H}.${string}` ? H :
+        S;
+export type ExtractParams<S extends string> = [ExtractParamKeys<S>] extends [never]
+    ? Record<string, never>
+    : { [K in ExtractParamKeys<S>]: string }
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE';
 /**
  * RequestInstance - Generic, model-aware request interface with Laravel-style methods.
@@ -151,4 +235,23 @@ export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' |
  * })
  * ```
  */
-export type ActionRequest<TFields extends Record<string, any> = Record<string, any>> = RequestInstance<TFields>;
+export type ActionRequest<TFields extends Record<string, any> = Record<string, any>, TParams extends Record<string, string> = Record<string, string>,> = RequestInstance<TFields, TParams>;
+/**
+ * Read the body shape declared by an action's `validations:` field as
+ * a TypeScript object type (stacksjs/stacks#1851 Phase 2b). Threaded
+ * into {@link RequestInstance}'s `TFields` so `request.all()` returns
+ * the body shape with the field types {@link Infer}'d from each
+ * `schema.X()` rule.
+ *
+ * @example
+ *   const validations = {
+ *     email:    { rule: schema.string().email() },
+ *     password: { rule: schema.string().min(8) },
+ *     remember: { rule: schema.boolean() },
+ *   } as const
+ *   type Body = InferValidations<typeof validations>
+ *   // → { email: string, password: string, remember: boolean }
+ */
+export type InferValidations<V extends Record<string, { rule: any }>> = {
+  [K in keyof V]: Infer<V[K]['rule']>
+}