doc: custom procedures sample (#554)

ymc9 · web-flow · commit 9436e76e8dec · 2026-01-09T20:55:27.000+08:00
diff --git a/.gitmodules b/.gitmodules
@@ -31,3 +31,6 @@
 [submodule "code-repos/zenstackhq/v3-doc-plugin"]
 	path = code-repos/zenstackhq/v3-doc-plugin
 	url = https://github.com/zenstackhq/v3-doc-plugin
+[submodule "code-repos/zenstackhq/v3-doc-orm-procedure"]
+	path = code-repos/zenstackhq/v3-doc-orm-procedure
+	url = https://github.com/zenstackhq/v3-doc-orm-procedure.git
diff --git a/code-repos/zenstackhq/v3-doc-orm-procedure b/code-repos/zenstackhq/v3-doc-orm-procedure
@@ -0,0 +1 @@
+Subproject commit ef3abb5d20feceb55472bb3b26194e342558c88e
diff --git a/code-repos/zenstackhq/v3-doc-plugin b/code-repos/zenstackhq/v3-doc-plugin
@@ -1 +1 @@
-Subproject commit 7807a354c182564301ba7a79789673d0c4b3d7d3
+Subproject commit 26575d2160a8d4db6eedf94a00580dd76d256dd7
diff --git a/docs/orm/custom-proc.md b/docs/orm/custom-proc.md
@@ -5,6 +5,7 @@ description: ORM custom procedures
 
 import PreviewFeature from '../_components/PreviewFeature';
 import AvailableSince from '../_components/AvailableSince';
+import StackBlitzGithub from '@site/src/components/StackBlitzGithub';
 
 # Custom Procedures
 
@@ -96,3 +97,7 @@ const feeds = await db.$procs.getUserFeeds({
 ## Error handling
 
 The `ZenStackClient` always throws an `ORMError` to the caller when an error occurs. To follow this protocol, custom procedure implementations should ensure other types of errors are caught and wrapped into `ORMError` and re-thrown. See [Error Handling](./errors.md) for more details.
+
+## Samples
+
+<StackBlitzGithub repoPath="zenstackhq/v3-doc-orm-procedure" openFile={['zenstack/schema.zmodel', 'main.ts']} startScript="dev" />
diff --git a/docs/orm/polymorphism.md b/docs/orm/polymorphism.md
@@ -30,4 +30,4 @@ The ORM query API hides all the complexity of managing polymorphic models for yo
 
 The schema used in the sample involves a base model and three concrete models:
 
-<StackBlitzGithub repoPath="zenstackhq/v3-doc-orm-polymorphism" codeFiles={['zenstack/schema.zmodel', 'main.ts']} startScript="generate,dev" />
+<StackBlitzGithub repoPath="zenstackhq/v3-doc-orm-polymorphism" openFile={['zenstack/schema.zmodel', 'main.ts']} startScript="dev" />

Original file line number	Diff line number	Diff line change
`@@ -30,4 +30,4 @@ The ORM query API hides all the complexity of managing polymorphic models for yo`
`30`	`30`
`31`	`31`	`The schema used in the sample involves a base model and three concrete models:`
`32`	`32`
`33`		`-<StackBlitzGithub repoPath="zenstackhq/v3-doc-orm-polymorphism" codeFiles={['zenstack/schema.zmodel', 'main.ts']} startScript="generate,dev" />`
	`33`	`+<StackBlitzGithub repoPath="zenstackhq/v3-doc-orm-polymorphism" openFile={['zenstack/schema.zmodel', 'main.ts']} startScript="dev" />`