doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

doc: release 3.8.0 - #619

Merged
ymc9 merged 2 commits into
mainfrom
doc/release-3.8
Jun 18, 2026
Merged

doc: release 3.8.0#619
ymc9 merged 2 commits into
mainfrom
doc/release-3.8

Conversation

@ymc9

@ymc9ymc9 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary by CodeRabbit

Documentation

  • Soft-Delete Plugin: Added comprehensive documentation explaining how the plugin works, including installation instructions, usage examples with runtime clients, compatibility with Kysely query builder, and important caveats around delete cascades and uniqueness constraints.
  • Input Validation: Extended validation documentation with new ISO 8601 date/time validation support, including @date and @time field decorators with customizable messages and precision options (available in v3.8.0).

@vercel

vercelBot commented Jun 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
zenstack-new-siteReadyReadyPreview, CommentJun 18, 2026 6:38am

Request Review

@coderabbitai

coderabbitaiBot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@ymc9, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 54 minutes and 57 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2ecbea90-9d6a-40b1-aca2-baaac4055ea8

📥 Commits

Reviewing files that changed from the base of the PR and between 0d66144 and aebe25b.

📒 Files selected for processing (1)
  • docs/reference/plugins/soft-delete.md

Walkthrough

Two documentation additions: a new reference page for the @zenstackhq/plugin-soft-delete plugin (behavioral model, installation, usage, caveats, and unique constraint migration guidance) and extensions to the ZModel input-validation reference adding @date/@time field attributes and isDate()/isTime() validation functions, all marked as available since v3.8.0.

Changes

Soft-delete plugin reference page

Layer / File(s)Summary
Plugin overview and @deletedAt attribute declaration
docs/reference/plugins/soft-delete.md
Introduces the behavioral model (delete→timestamp update, read filtering, update skip) and documents the @deletedAt ZModel attribute with its type and uniqueness constraints.
Installation, usage examples, and $qb escape hatch
docs/reference/plugins/soft-delete.md
Covers installation, ZModel model setup, runtime client usage, rewritten delete/read examples, and equivalent behavior via the Kysely $qb query builder.
Caveats and unique constraint migration guidance
docs/reference/plugins/soft-delete.md
Documents cascade and joined-delete caveats, explains soft-delete impact on unique constraints, and provides Postgres/SQLite partial index SQL and a MySQL generated-column workaround with a note to remove @unique from ZModel fields.

Input-validation date/time additions

Layer / File(s)Summary
@date/@time attributes and isDate()/isTime() functions
docs/reference/zmodel/input-validation.md
Adds @date and @time field-level attribute docs (with message and optional precision) and isDate()/isTime() predicate function entries, all annotated AvailableSince v3.8.0.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe PR title 'doc: release 3.8.0' clearly indicates it's a documentation update for a specific version release, which aligns with the changeset adding documentation for new v3.8.0 features (@date/@time validation and soft-delete plugin).
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch doc/release-3.8

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/reference/plugins/soft-delete.md`:
- Around line 96-102: The `@deletedAt` attribute documentation section is missing
the AvailableSince marker component. Add the AvailableSince component with
version v3.8.0 immediately after the `@deletedAt` heading and before the code
block showing the attribute syntax. This should be consistent with how other new
attributes like `@date` and `@time` are documented with their availability markers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 3acf7ac2-9669-4a00-a126-5426893fe778

📥 Commits

Reviewing files that changed from the base of the PR and between ca07626 and 0d66144.

📒 Files selected for processing (2)
  • docs/reference/plugins/soft-delete.md
  • docs/reference/zmodel/input-validation.md

Comment threaddocs/reference/plugins/soft-delete.md
@ymc9
ymc9 merged commit 58f9f39 into mainJun 18, 2026
4 checks passed
@ymc9
ymc9 deleted the doc/release-3.8 branch June 18, 2026 06:39
sanny-io pushed a commit to sanny-io/zenstack-docs that referenced this pull request Jul 31, 2026
* doc: release 3.8.0
* update
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@ymc9