@stacksjs/types 0.74.3 → 0.74.4

package/dist/dashboard.d.ts

@@ -61,6 +61,35 @@ export declare interface DashboardOptions {
       retentionHours?: number
     }
   }
+  providers?: DashboardProviderOptions
+}
+/**
+ * Credentials and endpoint for a hosted HQ product.
+ *
+ * `token` must be a READ token. A product's ingest key (the `loghq_...` value
+ * an app uses to SEND logs) grants no read access at all, so pasting one here
+ * produces an unauthorized response rather than data. The hosted read APIs
+ * currently authenticate a user rather than a machine, which is why this is
+ * separate from whatever ingest key `config/logging.ts` carries.
+ */
+export declare interface DashboardHqDriverOptions {
+  baseUrl?: string
+  token?: string
+  project?: string
+  timeoutMs?: number
+}
+/** One domain's provider choice, plus per-driver settings. */
+export declare interface DashboardProviderSelection {
+  driver?: DashboardProviderName
+  drivers?: {
+    hq?: DashboardHqDriverOptions
+  }
+}
+/** Per-domain provider selection. Omit a domain to leave it local. */
+export declare interface DashboardProviderOptions {
+  logs?: DashboardProviderSelection
+  errors?: DashboardProviderSelection
+  analytics?: DashboardProviderSelection
 }
 /**
  * Per-model dashboard configuration (stacksjs/stacks#1843).
@@ -115,4 +144,11 @@ export declare interface DashboardModelOptions {
   roles?: string[]
   description?: string
 }
+/**
+ * The backends a dashboard section can read from.
+ *
+ * `local` reads this application's own database and is the default.
+ * `hq` reads the matching hosted product (loghq, bughq, analyticshq).
+ */
+export type DashboardProviderName = 'local' | 'hq';
 export type DashboardConfig = Partial<DashboardOptions>;

package/dist/request.d.ts

@@ -1,7 +1,38 @@
-import { User } from '@stacksjs/orm';
 import type { AuthToken } from '@stacksjs/types';
 import type { Infer, IsRequired } from '@stacksjs/ts-validation';
 import type { UploadedFile } from '@stacksjs/storage';
+/**
+ * The row `request.user()` resolves to.
+ *
+ * Declared here rather than derived from `@stacksjs/orm`'s `User`, which is
+ * what this used to be. That single line put the ORM underneath everything
+ * that needs a type: `@stacksjs/logging` depends on this package, so logging
+ * transitively depended on the ORM, and the ORM depends on the router, which
+ * depends on this package again. A types package sits at the bottom of a
+ * stack or it drags whatever it imports down there with it.
+ *
+ * Nothing is lost in practice. The old type was intersected with
+ * `Record<string, any>` already, because the model proxy attaches trait
+ * methods ahead of time and an application's own User columns are its own -
+ * so every property access resolved through the index signature regardless.
+ *
+ * It is an interface so an application can have the precision back where it
+ * wants it:
+ *
+ * ```ts
+ * declare module '@stacksjs/types' {
+ *   interface AuthenticatedUser {
+ *     email: string
+ *     team_id: number
+ *   }
+ * }
+ * ```
+ */
+export declare interface AuthenticatedUser {
+  id: number
+  email: string
+  [key: string]: any
+}
 declare interface RequestData {
   [key: string]: any
 }
@@ -142,10 +173,7 @@ export declare interface RequestInstance<TFields extends Record<string, any> = R
   getMethod: () => HttpMethod
   user: () => Promise<UserJsonResponse | undefined>
 }
-// 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>;
+declare type UserJsonResponse = AuthenticatedUser;
 /**
  * Template-literal helper that extracts named route params from a
  * path string (stacksjs/stacks#1851 Phase 2a). Supports both Stacks's

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.74.3",
+  "version": "0.74.4",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,12 +58,11 @@
   "dependencies": {
     "@stacksjs/bunpress": "^0.2.8",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/events": "0.74.3",
-    "@stacksjs/orm": "0.74.3",
-    "@stacksjs/strings": "0.74.3",
+    "@stacksjs/events": "0.74.4",
+    "@stacksjs/strings": "0.74.4",
     "@stacksjs/stx": "^0.2.253",
     "@stacksjs/ts-validation": "^0.5.6",
-    "bun-query-builder": "^0.2.53"
+    "bun-query-builder": "^0.2.62"
   },
   "peerDependencies": {
     "meilisearch": "^0.59.0"
@@ -74,7 +73,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.74.3",
+    "@stacksjs/validation": "0.74.4",
     "better-dx": "^0.2.24",
     "meilisearch": "^0.59.0"
   },