docs: sync with current stratal codebase by adesege · Pull Request #1 · strataljs/docs

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege · 2026-06-11T23:43:42Z

Syncs the documentation site with the current state of the stratal framework, documenting user-facing changes and correcting stale API references. The tenancy package is intentionally excluded.

Features and behavior changes documented

Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation
Built-in DI container, lazy modules, and async provider disposal
Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline
Entity mutation events carrying full before/after snapshots
Quarry queue tooling (queue:list/failed/retry/purge), schedule:list, mcp:serve, and i18n commands
Failed-job handling and cleanup for queues
React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin
FreshSessionRequiredError and the full auth error surface
Test harness defaults (rate limiting off, in-memory email, eager routing in compile())
Middleware registration via RouteConfigurable / configureRoutes(router)
Tiered cache (isolate-local L1) and auto-registered storage routes
src/quarry.ts command entry, which keeps command code tree-shaken out of the Worker bundle

New pages

Rate limiting guide
Feature flags integration

Corrections

Remove reflect-metadata and tsyringe references throughout (clean break)
Fix the logger custom-formatter and testing env APIs that described removed symbols
Correct import subpaths (UseGuards → stratal/guards, Router/RouteConfigurable → stratal/router, Test → @stratal/testing) and renamed/removed symbols (SchemaSwitcher, CacheError, storage errors)
Remove em dashes site-wide

Verification

yarn build passes (73 pages)
Every stratal/* import in the docs cross-checked against the packages' actual exports

- Added new sections for Macroable, Domain Routing, Signed URLs, and Streaming Responses, enhancing the core concepts documentation. - Introduced Inertia-related guides covering CLI commands, flash messages, forms and validation, and React hooks for improved developer experience. - Updated existing documentation to include references to new topics, ensuring comprehensive coverage of features and best practices. - Enhanced navigation links for easier access to the newly added content.

…erences - Introduced a new documentation file for Access Control, detailing role-based permissions and how to define resources and roles. - Updated existing documentation to replace references to RBAC with Access Control, ensuring consistency across the framework. - Enhanced the Auth Guard documentation to clarify its integration with Access Control for permission checks. - Added new sections on modal handling in Inertia, improving the overall developer experience with backend-driven modals. - Revised CLI command documentation to reflect changes in command usage and improve clarity on Inertia operations.

Update the documentation to reflect user-facing changes in the stratal framework and correct stale API references. Features and behavior changes documented: - Trailing-slash exclusions ({ mode, exclude }) and locale-aware URL generation - Built-in DI container, lazy modules, and async provider disposal - Per-module keyed i18n namespaces, ICU message format, and the overhauled error-handling pipeline - Entity mutation events carrying full before/after snapshots - Quarry queue tooling, schedule:list, mcp:serve, and i18n commands - Failed-job handling and cleanup for queues - React 19 streaming SSR, Inertia modal fidelity, and the Vite plugin - FreshSessionRequiredError and the full auth error surface - Test harness defaults (rate limiting off, in-memory email, eager routing) - Middleware registration via RouteConfigurable/configureRoutes(router) - Tiered cache (isolate-local L1) and auto-registered storage routes - src/quarry.ts command entry for tree-shaking commands out of the Worker New pages: - Rate limiting guide - Feature flags integration Corrections: - Remove reflect-metadata and tsyringe references throughout - Fix logger custom-formatter and testing env APIs - Correct import subpaths (UseGuards, Router/RouteConfigurable, Test) and renamed/removed symbols - Remove em dashes site-wide

- Email: document the built-in SMTP client over cloudflare:sockets (no nodemailer, no provider SDKs); correct EmailModuleOptions to { from, smtp: { url }, replyTo, queue } and drop the provider/apiKey model - Storage: document native R2 bindings (StorageEntry { disk, binding, root }, r2_buckets); remove AWS SDK / S3 credential setup - Testing overview: replace the nodemailer-mock note with TestEmailProvider - Inertia: fix CLI commands to npx quarry inertia:*, the test HTTP API (module.http / .withBody / .send / awaited assertions), ctx.param/ctx.query/ ctx.c.get, and document the useSeo hook - OpenAPI schemas import from stratal/router, framework DATABASE_TOKENS, seeder scan note, testing seeder DI_TOKENS.Database - Validation: correct the error response shape (message/timestamp at 400, issues via a SchemaValidationError renderable) and the i18n locale detection

… context vars

adesege added 6 commits April 13, 2026 01:07

chore: pin Cloudflare account_id for non-interactive deploys
96d04eb