@stacksjs/types 0.75.262 → 0.75.263

package/dist/email.d.ts

@@ -127,13 +127,21 @@ export declare interface MailtrapConfig extends EmailDriverConfig {
   token: string
   inboxId?: number
 }
-export declare interface EmailResult {
+declare interface EmailResultFields {
   message: string
-  success: boolean
   provider: string
-  messageId?: string
   metadata?: Record<string, unknown>
 }
+/** A delivery the provider accepted. What `mail.sendOrFail()` resolves with. */
+export declare interface EmailSent extends EmailResultFields {
+  success: true
+  messageId?: string
+}
+/** A delivery that did not happen: unreachable host, rejected, suppressed. */
+export declare interface EmailFailed extends EmailResultFields {
+  success: false
+  messageId?: undefined
+}
 // Base configuration interface
 export declare interface EmailDriverConfig {
   maxRetries?: number
@@ -221,4 +229,14 @@ export type MailboxUserBackend = { driver: 'external' } | {
   region?: string
 }
 export type EmailConfig = Partial<EmailOptions>;
+/**
+ * The outcome `mail.send()` resolves with, either way.
+ *
+ * `send()` does not throw when delivery fails; it resolves with `success:
+ * false`. A union rather than one shape with a boolean, so a caller has to
+ * narrow on `success` before it can treat the result as sent, and so
+ * `sendOrFail()` can say in its type that it only ever resolves with a sent one
+ * (stacksjs/stacks#2930).
+ */
+export type EmailResult = EmailSent | EmailFailed;
 export type MailtrapResponse = MailtrapSuccessResponse | MailtrapErrorResponse;

package/dist/model.d.ts

@@ -143,6 +143,7 @@ export declare interface ShardingOptions {
 export declare interface SeedOptions {
   count: number
   fixtures?: Array<Record<string, unknown>>
+  after?: string[]
 }
 /** Which attributes `traits.useActivityLog` records. See the trait's docblock. */
 declare interface ActivityLogOption {
@@ -267,7 +268,7 @@ export declare interface Attribute {
   guarded?: boolean
   personal?: PersonalAttribute
   foreignKey?: boolean | ForeignKeyConfig
-  factory?: (faker: Faker, attributes: Readonly<Record<string, unknown>>) => any
+  factory?: (faker: Faker, attributes: Readonly<Record<string, unknown>>, context: { pick: (model: string, column?: string) => Promise<unknown> }) => any
   validation: {
     rule: ValidationType
     message?: ValidatorMessage

package/dist/security.d.ts

@@ -55,8 +55,10 @@ export type ApiRowScopingPolicy = 'warn' | 'deny';
 /**
  * Which models publish the REST API their `useApi` trait describes.
  *
- * - `'all'` (the default) - every `useApi` model, the framework's own included.
- * - `'own'` - only the app's models in `app/Models`, overrides included.
+ * - `'all'` - every `useApi` model, the framework's own included.
+ * - `'own'` (the default) - only the app's models in `app/Models`, overrides
+ *   included. It was `'all'` until stacksjs/stacks#2954, which published ~80
+ *   framework models' APIs over tables most apps never migrate.
  * - `'none'` - no generated model APIs.
  * - a list of model names - exactly those; `'own'` may be one of them, to mean
  *   the app's models plus the named framework ones.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.75.262",
+  "version": "0.75.263",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -64,8 +64,8 @@
   "dependencies": {
     "@stacksjs/bunpress": "^0.2.15",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/events": "0.75.262",
-    "@stacksjs/strings": "0.75.262",
+    "@stacksjs/events": "0.75.263",
+    "@stacksjs/strings": "0.75.263",
     "@stacksjs/stx": "0.2.661",
     "@stacksjs/ts-validation": "^0.5.6",
     "bun-query-builder": "^0.3.8"
@@ -79,7 +79,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.75.262",
+    "@stacksjs/validation": "0.75.263",
     "better-dx": "^0.2.24",
     "meilisearch": "^0.62.0"
   },