dyrected 2.5.49

package/dist/commands/sync-schema.js

@@ -0,0 +1,89 @@
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { createJiti } from "jiti";
+import { runGenerateTypes } from "../utils/type-generator.js";
+import { loadCommandEnv } from "../utils/env.js";
+export function registerSyncSchema(program) {
+    program
+        .command("sync:schema")
+        .description("Sync your local Dyrected schema with the Cloud dashboard")
+        .option("-k, --api-key <key>", "Your Dyrected API Key")
+        .option("-s, --site-id <id>", "Your Dyrected Site ID")
+        .option("-u, --url <url>", "Cloud API URL", "https://cloud.dyrected.com")
+        .option("-c, --config <path>", "Path to your dyrected.config.ts", "./dyrected.config.ts")
+        .option("--env-path <path>", "Path to an env file to load before syncing")
+        .option("--skip-on-error", "Do not exit with error if sync fails (useful for CI builds)")
+        .option("--skip-types", "Skip automatic type generation after a successful sync")
+        .addHelpText("after", `
+Examples:
+  # Sync using env vars (DYRECTED_API_KEY, DYRECTED_SITE_ID)
+  $ npx dyrected sync:schema
+
+  # Sync using a specific env file
+  $ npx dyrected sync:schema --env-path ./.env.local
+
+  # Sync with explicit credentials
+  $ npx dyrected sync:schema --api-key <key> --site-id <id>
+
+  # Sync in CI without failing the build on error
+  $ npx dyrected sync:schema --skip-on-error
+
+  # Sync without regenerating types
+  $ npx dyrected sync:schema --skip-types
+`)
+        .action(async (options) => {
+        try {
+            await loadCommandEnv({ cwd: process.cwd(), envPath: options.envPath });
+            const apiKey = options.apiKey || process.env.DYRECTED_API_KEY;
+            const siteId = options.siteId || process.env.DYRECTED_SITE_ID;
+            const apiUrl = options.url || process.env.DYRECTED_URL || "https://cloud.dyrected.com";
+            const configPath = path.resolve(process.cwd(), options.config);
+            if (!apiKey || !siteId) {
+                console.warn(chalk.yellow("\n⚠  Skipping schema sync: API Key or Site ID missing. (Required for Cloud sync, but optional for self-hosted builds)\n"));
+                return;
+            }
+            if (!(await fs.pathExists(configPath))) {
+                throw new Error(`Config file not found at ${configPath}`);
+            }
+            console.log(chalk.blue(`Loading config from ${configPath}...`));
+            const jiti = createJiti(configPath);
+            const configModule = (await jiti.import(configPath));
+            const config = configModule.default || configModule;
+            if (!config.collections)
+                throw new Error("Invalid config: No collections found.");
+            console.log(chalk.blue(`Syncing schema to ${apiUrl}...`));
+            const response = await fetch(`${apiUrl}/cloud/workspaces/sites/${siteId}/schema/sync`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                    "X-API-Key": apiKey,
+                },
+                body: JSON.stringify({
+                    collections: config.collections,
+                    globals: config.globals || [],
+                    admin: config.admin || {},
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({ message: response.statusText }));
+                throw new Error(`Sync failed: ${error.message || response.statusText}`);
+            }
+            console.log(chalk.green(`✔  Schema synced successfully for site ${siteId}`));
+            if (!options.skipTypes) {
+                console.log(chalk.blue("\nGenerating types from synced schema..."));
+                await runGenerateTypes({ config: options.config, output: "./dyrected-types.ts" });
+            }
+        }
+        catch (error) {
+            if (options.skipOnError) {
+                console.warn(chalk.yellow(`\n⚠  Sync failed, but skipping error as requested: ${error.message}`));
+                return;
+            }
+            console.error(chalk.red(`\nError: ${error.message}`));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=sync-schema.js.map

package/dist/commands/sync-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-schema.js","sourceRoot":"","sources":["../../src/commands/sync-schema.ts"],"names":[],"mappings":"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"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerUpgrade(program: Command): void;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,QA0D/C"}

package/dist/commands/upgrade.js

@@ -0,0 +1,58 @@
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "path";
+import { execSync } from "child_process";
+import { detectPackageManager } from "../utils/detect.js";
+export function registerUpgrade(program) {
+    program
+        .command("upgrade")
+        .description("Upgrade all Dyrected packages to the latest version")
+        .action(async () => {
+        const cwd = process.cwd();
+        const pkgPath = path.join(cwd, "package.json");
+        if (!(await fs.pathExists(pkgPath))) {
+            console.error(chalk.red("Error: No package.json found in the current directory."));
+            process.exit(1);
+        }
+        let pkg;
+        try {
+            pkg = await fs.readJson(pkgPath);
+        }
+        catch (err) {
+            console.error(chalk.red("Error: Failed to read package.json."));
+            process.exit(1);
+        }
+        const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+        const dyrectedDeps = Object.keys(allDeps).filter((dep) => dep.startsWith("@dyrected/") || dep === "dyrected");
+        if (dyrectedDeps.length === 0) {
+            console.log(chalk.yellow("No Dyrected dependencies found in package.json."));
+            return;
+        }
+        console.log(chalk.blue(`Found Dyrected packages to upgrade: ${dyrectedDeps.join(", ")}`));
+        const packageManager = detectPackageManager(cwd);
+        const installArgs = dyrectedDeps.map((dep) => `${dep}@latest`).join(" ");
+        let cmd = "";
+        if (packageManager === "yarn") {
+            cmd = `yarn add ${installArgs}`;
+        }
+        else if (packageManager === "pnpm") {
+            cmd = `pnpm add ${installArgs}`;
+        }
+        else if (packageManager === "bun") {
+            cmd = `bun add ${installArgs}`;
+        }
+        else {
+            cmd = `npm install ${installArgs}`;
+        }
+        console.log(chalk.blue(`Running: ${cmd}`));
+        try {
+            execSync(cmd, { cwd, stdio: "inherit" });
+            console.log(chalk.green("\n✔  All Dyrected packages successfully upgraded to the latest version!"));
+        }
+        catch (err) {
+            console.error(chalk.red(`\nFailed to upgrade packages. Try running manually:\n  ${cmd}`));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerInit } from "./commands/init.js";
+import { registerGenerateTypes } from "./commands/generate-types.js";
+import { registerGenerateAiRules } from "./commands/generate-ai-rules.js";
+import { registerSyncSchema } from "./commands/sync-schema.js";
+import { registerUpgrade } from "./commands/upgrade.js";
+const program = new Command();
+program
+    .name("dyrected")
+    .description("Dyrected CMS CLI tool")
+    .version("0.0.1")
+    .addHelpText("after", `
+Commands:
+  init              Bootstrap Dyrected in your project (interactive)
+  upgrade           Upgrade all Dyrected packages to the latest version
+  generate:types    Generate TypeScript types from your schema
+  generate:ai-rules Generate canonical instructions for AI coding tools
+  sync:schema       Push your local schema to Dyrected Cloud
+
+Run \`npx dyrected <command> --help\` for detailed usage and examples.
+`);
+registerInit(program);
+registerUpgrade(program);
+registerGenerateTypes(program);
+registerGenerateAiRules(program);
+registerSyncSchema(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,uBAAuB,CAAC;KACpC,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CACV,OAAO,EACP;;;;;;;;;CASH,CACE,CAAC;AAEJ,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAE5B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/utils/ai-rules-template.d.ts

@@ -0,0 +1,2 @@
+export declare function buildAiRules(): string;
+//# sourceMappingURL=ai-rules-template.d.ts.map

package/dist/utils/ai-rules-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-rules-template.d.ts","sourceRoot":"","sources":["../../src/utils/ai-rules-template.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,IAAI,MAAM,CAyZrC"}

package/dist/utils/ai-rules-template.js

@@ -0,0 +1,411 @@
+export function buildAiRules() {
+    return `# Dyrected AI Rules
+
+> This is the canonical instruction file for AI coding agents working with Dyrected.
+> The Dyrected CLI also creates tool-specific pointer files so supported agents load it automatically.
+>
+> Full documentation: https://docs.dyrected.com
+
+---
+
+## Before writing any code
+
+1. Read https://docs.dyrected.com before writing any integration code
+2. Check the installed package version and its exported types — do not assume API shape from memory
+3. Use only APIs that exist in the installed version; if the docs and the package disagree, use the package
+4. Read the existing \`dyrected.config.ts\` before suggesting any schema change
+5. Never invent field types, hook names, config options, or API methods
+
+---
+
+## Core imports
+
+\`\`\`ts
+import { defineCollection, defineGlobal, defineConfig } from '@dyrected/core'
+import { DyrectedClient } from '@dyrected/sdk'
+\`\`\`
+
+---
+
+## Available field types
+
+\`text\`, \`textarea\`, \`richText\`, \`number\`, \`boolean\`, \`date\`, \`datetime\`, \`time\`,
+\`email\`, \`url\`, \`icon\`, \`json\`, \`select\`, \`multiSelect\`, \`radio\`,
+\`relationship\`, \`image\`, \`object\`, \`array\`, \`blocks\`, \`row\`, \`join\`
+
+Do not invent field types that are not in this list.
+
+Docs: https://docs.dyrected.com/docs/concepts/fields
+
+---
+
+## Never do these things
+
+- **Never use \`client.collections\`** — the only correct entry point is \`client.collection('slug')\`
+- **Never add custom auth or session middleware on admin routes** — Dyrected handles authentication internally; adding your own breaks the dashboard
+- **Never define \`email\` or \`password\` fields on an \`auth: true\` collection** — they are injected automatically
+- **Never delete a field from the config** — existing documents store data under that key; removing it orphans the data permanently
+- **Never rename a field directly** — use \`renameTo\` for a lazy, zero-downtime migration (see Schema Evolution below)
+- **Never add a new field to an existing collection without \`defaultValue\`** — existing documents need a safe read fallback
+- **Never use function callbacks in \`admin.condition\`** if the project uses Dyrected Cloud — use Jexl string expressions instead; functions are stripped on cloud sync
+
+---
+
+## Schema evolution
+
+Full guide: https://docs.dyrected.com/docs/concepts/schema
+
+### Renaming a field safely
+
+\`\`\`ts
+{
+  name: 'fullName',   // new name
+  type: 'text',
+  renameTo: 'name',   // old name — fallback on read until all docs are resaved
+}
+\`\`\`
+
+Remove \`renameTo\` once all documents in production have been resaved under the new name.
+
+### Indexing a field for fast queries
+
+\`\`\`ts
+{ name: 'slug', type: 'text', unique: true, promoted: true }
+\`\`\`
+
+After adding \`promoted: true\`, run \`npx @dyrected/cli sync:schema\` (Cloud) or restart the server (self-hosted).
+Supported types: \`text\`, \`number\`, \`boolean\`, \`date\`, \`datetime\`.
+
+---
+
+## Zero-state resilience
+
+Always write frontend data fetches with \`initialData\` fallbacks so the page renders when the backend
+is unreachable or the collection is empty.
+
+\`\`\`ts
+const { docs } = await client.collection('posts').find({ initialData: [] })
+const settings  = await client.global('site-settings').get({ initialData: { siteName: 'My Site' } })
+\`\`\`
+
+---
+
+## Relationships and depth
+
+Docs: https://docs.dyrected.com/docs/concepts/relationships | https://docs.dyrected.com/docs/concepts/depth
+
+A \`relationship\` field stores the ID of a document in another collection (the owning side).
+A \`join\` field is a virtual reverse lookup — it stores nothing; it queries the other collection at read time.
+
+\`\`\`ts
+// relationship — stores an ID
+{ name: 'author', type: 'relationship', relationTo: 'users' }
+{ name: 'tags',   type: 'relationship', relationTo: 'tags', hasMany: true }
+
+// join — virtual reverse lookup (no storage)
+{
+  name: 'posts',
+  type: 'join',
+  collection: 'posts',  // the collection to look in
+  on: 'author',         // the relationship field on that collection
+  limit: 20,
+}
+\`\`\`
+
+Control how many levels of relationships are hydrated with \`depth\`:
+
+- \`depth: 0\` — return IDs only
+- \`depth: 1\` (default) — hydrate direct relationships; nested ones remain IDs
+- \`depth: 2\` — hydrate two levels deep
+
+Use \`depth: 0\` on list pages to keep payloads small. Use \`depth: 1\` (the default) when you need related field values.
+
+---
+
+## Auth collections
+
+Docs: https://docs.dyrected.com/docs/concepts/auth-model
+
+\`auth: true\` turns a collection into an authentication provider. Dyrected automatically injects
+\`email\` (required, unique) and \`password\` (hashed, never returned in responses) — do not define them yourself.
+
+\`\`\`ts
+export const Users = defineCollection({
+  slug: 'users',
+  auth: true,
+  fields: [
+    { name: 'name', type: 'text' },
+    { name: 'role', type: 'select', options: ['member', 'editor', 'admin'] },
+  ],
+})
+\`\`\`
+
+Generated endpoints (all under \`/dyrected/api/{slug}/\`): \`login\`, \`logout\`, \`me\`, \`refresh-token\`,
+\`forgot-password\`, \`reset-password\`, \`invite\`, \`accept-invite\`, \`first-user\`, \`init\`.
+
+The admin dashboard uses a **separate** auth collection by convention. Define it as:
+
+\`\`\`ts
+export const Admins = defineCollection({
+  slug: '__admins',
+  auth: true,
+  fields: [],  // email + password are automatic
+})
+\`\`\`
+
+Do not mix app user auth and admin auth in the same collection unless you explicitly want editors to log into both.
+
+---
+
+## Upload collections
+
+Docs: https://docs.dyrected.com/docs/guides/file-uploads
+
+\`upload: true\` turns a collection into a media library. Dyrected automatically injects \`filename\`,
+\`mimeType\`, \`url\`, \`filesize\`, \`width\`, \`height\`, and \`blurhash\`.
+
+\`\`\`ts
+export const Media = defineCollection({
+  slug: 'media',
+  upload: {
+    allowedMimeTypes: ['image/*'],
+    maxFileSize: 5_000_000,         // bytes
+    imageSizes: [
+      { name: 'thumbnail', width: 300, height: 300, crop: 'cover' },
+      { name: 'card',      width: 800 },
+    ],
+  },
+  fields: [
+    { name: 'alt', type: 'text' },
+  ],
+})
+\`\`\`
+
+---
+
+## Dynamic options (select / multiSelect / radio)
+
+Docs: https://docs.dyrected.com/docs/concepts/dynamic-options
+
+Three ways to populate options — pick the right one:
+
+| Approach | Where it runs | Use when |
+|---|---|---|
+| Static array | — | Fixed list known at build time |
+| Server-side resolver (async function) | Server | DB queries, API keys, user-filtered lists, caching |
+| \`admin.hooks.options\` (UI hook) | Browser | Instant dependent/cascading dropdowns |
+
+\`\`\`ts
+// Server-side resolver — runs on the server, never sent to the browser
+{
+  name: 'category',
+  type: 'select',
+  options: async ({ db }) => {
+    const result = await db.find({ collection: 'categories' })
+    return result.docs.map(c => ({ label: c.name, value: c.id }))
+  },
+}
+
+// Client-side UI hook — runs in the browser, instant, no network round-trip
+{
+  name: 'region',
+  type: 'select',
+  options: [],
+  admin: {
+    hooks: {
+      options: ({ siblingData }) =>
+        siblingData.country === 'us'
+          ? [{ label: 'California', value: 'CA' }, { label: 'New York', value: 'NY' }]
+          : [],
+    },
+  },
+}
+\`\`\`
+
+---
+
+## Conditional fields
+
+Docs: https://docs.dyrected.com/docs/admin/configuration#condition--conditional-fields
+
+Use \`admin.condition\` to show or hide a field based on sibling values. Use Jexl string expressions
+(not functions) for cloud compatibility:
+
+\`\`\`ts
+// Only show 'scheduledAt' when status is 'scheduled'
+{
+  name: 'scheduledAt',
+  type: 'datetime',
+  admin: {
+    condition: 'status == "scheduled"',
+  },
+}
+
+// Complex logic
+{
+  name: 'salePrice',
+  type: 'number',
+  admin: {
+    condition: 'onSale == true && price > 0',
+  },
+}
+\`\`\`
+
+---
+
+## Custom field components and component slots
+
+Docs: https://docs.dyrected.com/docs/admin/configuration
+
+### Custom field input
+
+Replace any field's default input with a custom component. Declare a unique string key in the config:
+
+\`\`\`ts
+{
+  name: 'brandColor',
+  type: 'text',
+  admin: {
+    component: 'products.brandColor',
+  },
+}
+\`\`\`
+
+Register the component in your \`<DyrectedAdmin>\` wrapper:
+
+\`\`\`tsx
+// React / Next.js
+<DyrectedAdmin components={{ fields: { 'products.brandColor': BrandColorPicker } }} />
+
+// Vue / Nuxt
+<DyrectedAdmin :components="{ fields: { 'products.brandColor': BrandColorPicker } }" />
+\`\`\`
+
+The component receives \`value\`, \`onChange\`, \`field\`, \`path\`, \`disabled\`, and \`collection\` as props.
+
+### Component slots (dashboard and collection pages)
+
+Inject custom panels into the dashboard or collection list pages by declaring slot keys in the config
+and providing the matching components to \`<DyrectedAdmin>\`:
+
+\`\`\`ts
+// dyrected.config.ts
+defineConfig({
+  admin: {
+    components: ['dashboard.analytics'],   // slot key
+  },
+  ...
+})
+\`\`\`
+
+\`\`\`tsx
+<DyrectedAdmin
+  components={{
+    slots: { 'dashboard.analytics': AnalyticsDashboard }
+  }}
+/>
+\`\`\`
+
+---
+
+## Intent → pattern
+
+Translate plain-language goals to the correct Dyrected pattern. Make the decision yourself
+— do not ask the developer to choose between Dyrected concepts.
+
+| If the user wants to…                                              | Use this pattern |
+|--------------------------------------------------------------------|------------------|
+| Auto-generate a slug from a title                                  | \`beforeChange\` collection hook (server) + \`admin.hooks.onChange\` on the slug field (live preview) |
+| Validate data before saving                                        | \`beforeChange\` collection hook — throw to abort |
+| Run logic after a document is saved                                | \`afterChange\` collection hook — never \`await\` slow ops inline; use \`.catch()\` |
+| Send a webhook or email when content changes                       | \`afterChange\` collection hook |
+| Revalidate a Next.js / Nuxt page after a save                     | \`afterChange\` collection hook posting to the revalidation endpoint |
+| Only admins can see a field                                        | Field-level \`access: { read: ({ user }) => user?.roles?.includes('admin') ?? false }\` |
+| Different roles can edit different fields                          | Field-level \`access.update\` |
+| Restrict who can create / edit / delete                            | Collection-level \`access\` config |
+| Track who created or changed a document                            | \`audit: true\` on the collection |
+| Content approval / draft-publish flow                              | \`workflow: publishingWorkflow()\` on the collection |
+| Guard a workflow transition                                        | \`workflow.hooks.beforeTransition\` — throw to cancel |
+| Notify someone after a workflow state change                       | \`workflow.hooks.afterTransition\` |
+| Different content per site (multi-tenant)                          | \`siteId\` on the collection + \`beforeRead\` hook to scope queries |
+| Share content across all sites                                     | \`shared: true\` on the collection |
+| Show a dependent dropdown based on another field (instant)         | \`admin.hooks.options\` on the dependent select field |
+| Populate a dropdown from a database query or external API          | Server-side \`options\` async resolver function |
+| Show a live computed value in the admin form                       | \`admin.hooks.onChange\` on the output field |
+| Show or hide a field based on another field's value                | \`admin.condition\` with a Jexl string expression |
+| Query or sort a field efficiently at scale                         | \`promoted: true\` on the field, then run \`sync:schema\` |
+| One fixed set of content (site name, logo, tagline…)               | \`defineGlobal\` |
+| Multiple entries the client can add or remove                      | \`defineCollection\` |
+| Flexible page layouts (hero, cards, testimonials…)                 | \`blocks\` field — one block definition per layout type |
+| Seed default content on first run                                  | \`initialData\` on the collection or global |
+| Reference a document in another collection                         | \`relationship\` field with \`relationTo: 'slug'\` |
+| Store multiple references (tags, categories…)                      | \`relationship\` field with \`hasMany: true\` |
+| Show all related documents on the other side (reverse lookup)      | \`join\` field with \`collection\` and \`on\` |
+| Fetch a document with its related data populated                   | Use \`depth: 1\` (default) on the query |
+| Allow users to log in to the app                                   | \`auth: true\` on a collection |
+| Separate admin login from app user login                           | Define a \`__admins\` collection with \`auth: true\` |
+| Allow file / image uploads                                         | \`upload: true\` (or an upload config object) on a collection |
+| Replace the default input for a field with a custom component      | \`admin.component\` string key + register in \`<DyrectedAdmin>\` |
+| Inject a custom panel into the dashboard or a collection page      | Component slots in \`admin.components\` config + register in \`<DyrectedAdmin>\` |
+
+---
+
+## Canonical recipe: generate a slug from a title
+
+When the developer asks for automatic URLs, friendly URLs, or a slug derived from a title, implement both layers below. The server hook guarantees API writes are correct; the Admin hook gives editors immediate feedback.
+
+\`\`\`ts
+const toSlug = (value: unknown) =>
+  String(value ?? '')
+    .toLowerCase()
+    .trim()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/(^-|-$)/g, '')
+
+export const Posts = defineCollection({
+  slug: 'posts',
+  hooks: {
+    beforeChange: [({ data, operation }) => {
+      if (operation === 'create' || data.title !== undefined) {
+        return { ...data, slug: toSlug(data.title) }
+      }
+      return data
+    }],
+  },
+  fields: [
+    { name: 'title', type: 'text', required: true },
+    {
+      name: 'slug', type: 'text', required: true, unique: true, promoted: true,
+      admin: { hooks: { onChange: ({ siblingData }) => toSlug(siblingData.title) } },
+    },
+  ],
+})
+\`\`\`
+
+Do not implement only the browser hook: API-created documents would bypass it. Do not implement only the server hook when editors need to see the resulting URL while typing.
+
+---
+
+## Access control
+
+Docs: https://docs.dyrected.com/docs/concepts/access-control
+
+- Create the smallest set of permissions needed for the approved use case
+- Editors may access only the content they are approved to edit
+- Do not grant delete or publish access unless explicitly required
+- Enforce access in the server-side config — not only by hiding controls in the Admin UI
+
+---
+
+## Working approach
+
+- Work in small verified batches — no more than three related content areas at a time
+- Verify lint, types, and build pass before moving to the next batch
+- Fix a failing batch before starting new content types
+- Ask plain-language questions when you need clarification:
+  e.g. "Should the client be able to add more items, or only edit the ones already there?"
+  Never ask: "Should this be a collection or a global?"
+- Use the intent → pattern table above to make technical decisions without asking the developer
+`;
+}
+//# sourceMappingURL=ai-rules-template.js.map

package/dist/utils/ai-rules-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-rules-template.js","sourceRoot":"","sources":["../../src/utils/ai-rules-template.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuZR,CAAC;AACF,CAAC"}

package/dist/utils/config-templates.d.ts

@@ -0,0 +1,5 @@
+export declare function buildDbConfig(db: string): string;
+export declare function buildStorageConfig(storage: string): string;
+export declare function buildEnvTemplate(db: string, storage: string, framework: string): string;
+export declare function buildViteEnvTemplate(): string;
+//# sourceMappingURL=config-templates.d.ts.map

package/dist/utils/config-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-templates.d.ts","sourceRoot":"","sources":["../../src/utils/config-templates.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAahD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CA8CR;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C"}