@stacksjs/types 0.75.34 → 0.75.36

package/dist/app.d.ts

@@ -1,3 +1,4 @@
+import type { SeoOptions } from './seo';
 /**
  * **Application Options**
  *
@@ -25,6 +26,7 @@ export declare interface AppOptions {
   docMode: boolean
   primaryColor: string
   supportEmail: string
+  seo?: SeoOptions
 }
 // `(string & {})` rather than a bare `string`, which would absorb every
 // literal beside it and collapse the union to `string` - erasing the named

package/dist/auth.d.ts

@@ -44,6 +44,14 @@ export declare interface OAuthProviderConsentWorkspaceContext {
   user: AuthenticatedUser
   request: RequestInstance
 }
+/** Current subject and delegated grant presented to an OAuth policy hook. */
+export declare interface OAuthProviderSubject {
+  type: string
+  id: number
+  clientId: number
+  grantId: string
+  workspaceId: string | null
+}
 export declare interface OAuthProviderConfig {
   enabled?: boolean
   issuer?: string
@@ -51,10 +59,14 @@ export declare interface OAuthProviderConfig {
     authorization?: string
     token?: string
     revocation?: string
+    introspection?: string
   }
   scopes?: Record<string, OAuthProviderScopeConfig>
   resources?: Record<string, OAuthProviderResourceConfig>
   clientTypes?: readonly ('confidential' | 'public')[]
+  clientCredentials?: boolean
+  introspection?: boolean
+  subjectEligibility?: OAuthProviderSubjectEligibility
   lifetimes?: {
     authorizationRequest?: number
     authorizationCode?: number
@@ -143,6 +155,16 @@ export declare interface Authenticatable {
 export type OAuthProviderConsentWorkspaceResolver = (
   context: OAuthProviderConsentWorkspaceContext,
 ) => OAuthProviderConsentWorkspace | null | Promise<OAuthProviderConsentWorkspace | null>;
+/**
+ * Application-owned eligibility policy for delegated OAuth subjects.
+ *
+ * The default provider can verify that a user row still exists, but only the
+ * application knows whether an account is disabled, suspended, or otherwise
+ * barred from receiving delegated access.
+ */
+export type OAuthProviderSubjectEligibility = (
+  subject: OAuthProviderSubject,
+) => boolean | Promise<boolean>;
 export type AuthConfig = Partial<AuthOptions>;
 export type GuardType = 'session' | 'token';
 export type ProviderType = 'database';

package/dist/index.d.ts

@@ -71,6 +71,7 @@ export * from './saas';
 export * from './scheduler';
 export * from './search-engine';
 export * from './security';
+export * from './seo';
 export * from './server';
 export * from './services';
 export * from './sites';

package/dist/seo.d.ts

@@ -0,0 +1,41 @@
+/**
+ * **SEO Options** (`config/app.ts` → `seo`)
+ *
+ * The views server answers `/sitemap.xml` and `/robots.txt` for every app, in
+ * development and production alike, generated from `resources/views` at
+ * request time. Nothing here is required: an app with no `seo` block gets a
+ * sitemap of its static pages and a robots.txt that points at it.
+ *
+ * A page stays out of the sitemap when its source says `noindex` - a
+ * `<meta name="robots" content="noindex">` tag, a `robots: 'noindex'` head
+ * entry, or the `const noindex = true` flag a shared head partial turns into
+ * that tag - or when it is dynamic (`[param].stx`), an error page, behind the
+ * `auth` page middleware, or disallowed by robots.txt.
+ */
+export declare interface SeoOptions {
+  origin?: string
+  handwritten?: 'prefer' | 'replace'
+  sitemap?: false | SeoSitemapOptions
+  robots?: false | SeoRobotsOptions
+}
+export declare interface SeoSitemapEntry {
+  loc: string
+  lastmod?: string
+  changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never'
+  priority?: number
+}
+export declare interface SeoSitemapOptions {
+  include?: (string | SeoSitemapEntry)[]
+  entries?: () => (string | SeoSitemapEntry)[] | Promise<(string | SeoSitemapEntry)[]>
+  exclude?: string[]
+}
+export declare interface SeoRobotsRule {
+  userAgent: string
+  allow?: string[]
+  disallow?: string[]
+  crawlDelay?: number
+}
+export declare interface SeoRobotsOptions {
+  disallow?: string[]
+  rules?: SeoRobotsRule[]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.75.34",
+  "version": "0.75.36",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,9 +58,9 @@
   "dependencies": {
     "@stacksjs/bunpress": "^0.2.8",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/events": "0.75.34",
-    "@stacksjs/strings": "0.75.34",
-    "@stacksjs/stx": "^0.2.341",
+    "@stacksjs/events": "0.75.36",
+    "@stacksjs/strings": "0.75.36",
+    "@stacksjs/stx": "^0.2.343",
     "@stacksjs/ts-validation": "^0.5.6",
     "bun-query-builder": "^0.3.0"
   },
@@ -73,7 +73,7 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.75.34",
+    "@stacksjs/validation": "0.75.36",
     "better-dx": "^0.2.24",
     "meilisearch": "^0.59.0"
   },