@microsoft/rayfin-guide 1.34.0-alpha.1225 → 1.34.0-alpha.1272

package/assets/docs/cli/templates.md

@@ -104,7 +104,7 @@ Pass a relative or absolute path to `-t`/`--template` when the template is alrea
 npx rayfin init my-app -t ./my-template
 ```
 
-Local templates use the same `rayfin-template.yml` file format as git-backed templates for top-level entries.
+Local templates use the same `rayfin-template.yml` file format as git-backed templates, including grouped entries for nested navigation.
 
 > **Bare names resolve as template names, not paths.**
 > Use `./`, `../`, or an absolute path when pointing at a local directory:
@@ -343,8 +343,7 @@ entries:
     path: ./templates/fullstack
 ```
 
-For local template directories, keep entries at the top level of `entries`.
-Grouped nested navigation is available for git-backed template sources.
+Local and git-backed template sources both support grouped nested navigation.
 
 ### Group entries for nested navigation
 

package/assets/docs/data/overview.md

@@ -197,24 +197,13 @@ The regeneration step updates tables, relationships, and permissions so subseque
 Rayfin uses class-level role decorators to generate Data API Builder (DAB) permissions.
 Use `@role()` directly, or the `@anonymous()` and `@authenticated()` shorthands.
 
-> **Anonymous data access is not currently supported on Fabric.**
-> Both `@anonymous(...)` and `@role('anonymous', …)` are accepted at compile time, but `rayfin dev` and `rayfin up`, along with any sub-command that involves creating, updating, or applying data schema, reject any DAB configuration that grants the `anonymous` role. Remove the `@anonymous(...)` decorator (or `@role('anonymous', …)`) from your entities; all access then goes through the `authenticated` role.
->
-> The `@anonymous()` shorthand is published from the experimental subpath as a preview of the future supported syntax:
->
-> ```typescript
-> import { anonymous } from '@microsoft/rayfin-core/experimental';
-> ```
->
-> The `@role('anonymous', …)` form is also importable from `@microsoft/rayfin-core/experimental` and behaves identically.
-
 ### Public read, authenticated write
 
-The shape below previews the future syntax for public-read access. Anonymous data access is **not currently supported on Fabric**, so applying this schema fails today; remove `@anonymous('read')` to fall back to authenticated-only access.
+Grant unauthenticated callers read access with `@anonymous('read')` while
+keeping writes restricted to the owning authenticated user.
 
 ```typescript
-import { entity, authenticated, uuid, text } from '@microsoft/rayfin-core';
-import { anonymous } from '@microsoft/rayfin-core/experimental';
+import { entity, anonymous, authenticated, uuid, text } from '@microsoft/rayfin-core';
 
 @entity()
 @anonymous('read')
@@ -253,6 +242,7 @@ export class Document {
 - `@role()` applies to classes.
 Field visibility is configured through role options.
 - Only the built-in roles are supported today: `anonymous` and `authenticated`.
+- To use anonymous data with Microsoft Fabric, please reach out to your tenant admin to enable the tenant admin switch "Enable anonymous data access for Fabric Apps"
 
 ## Best practices
 

package/assets/docs/getting-started/create-app-with-cli.md

@@ -27,10 +27,10 @@ Visit and ensure you can view the Timestamp Tracker.
 Add a `message` field to the **Timestamp** entity in `rayfin/data/Timestamp.ts`.
 
 ```typescript
-import { entity, authenticated, uuid, text, date } from '@microsoft/rayfin-core';
+import { entity, anonymous, uuid, text, date } from '@microsoft/rayfin-core';
 
 @entity()
-@authenticated('*')
+@anonymous()
 export class Timestamp {
   @uuid() id!: string;
   @date() timestamp!: Date;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/rayfin-guide",
-  "version": "1.34.0-alpha.1225",
+  "version": "1.34.0-alpha.1272",
   "description": "Cross-cutting Builder guides for the Rayfin platform — discovered by `@microsoft/rayfin-docs` via the `rayfinDocs` package.json field convention.",
   "type": "module",
   "files": [