@dyrected/core 0.0.1 → 1.0.1

package/dist/index.js

@@ -1,374 +1,308 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+import {
+  normalizeConfig
+} from "./chunk-GM4WW6IE.js";
 
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  MediaService: () => MediaService,
-  PopulationService: () => PopulationService,
-  createDyrectedApp: () => createDyrectedApp,
-  defineCollection: () => defineCollection,
-  defineConfig: () => defineConfig,
-  defineGlobal: () => defineGlobal
-});
-module.exports = __toCommonJS(index_exports);
+// src/utils/setup-prompt.ts
+function generateAIPrompt(activeTab, config) {
+  const frameworkLabel = activeTab === "next" ? "Next.js" : activeTab === "nuxt" ? "Nuxt" : activeTab.charAt(0).toUpperCase() + activeTab.slice(1);
+  const backendPkg = activeTab === "nuxt" ? "@dyrected/nuxt" : "@dyrected/next";
+  const isSelfHosted = config.isSelfHosted ?? (config.baseUrl?.includes("localhost") || !config.apiKey);
+  const baseIntro = isSelfHosted ? `You are a Senior Content Architect. Your mission is to integrate Dyrected CMS into a ${config.siteName || "new"} project using ${frameworkLabel}. This is a SELF-HOSTED installation.
+The backend is already configured via ${backendPkg}.
+Your priority is DATA PRESERVATION and creating a CMS that empowers marketing teams.` : `You are a Senior Content Architect. Your mission is to integrate Dyrected CMS into a ${config.siteName || "new"} project using ${frameworkLabel}. Complete the entire setup automatically, including embedding the Admin UI and syncing the schema. Your priority is DATA PRESERVATION and marketing independence.`;
+  const credentials = `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+SITE CREDENTIALS
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+${config.siteName ? `Site Name : ${config.siteName}
+` : ""}${isSelfHosted ? "" : `Site ID   : ${config.siteId}
+API Key   : ${config.apiKey}
+`}API URL   : ${config.baseUrl || "https://api.dyrected.cloud"}
+`;
+  const importantNotes = `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+IMPORTANT NOTES \u2014 READ BEFORE ACTING
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+- \`client.collection(slug)\` is the primary API entrypoint. Do NOT use \`client.collections\`.
+- Blocks are stored as \`[{ blockType: '<slug>', ...fields }]\` \u2014 always switch on \`blockType\` when rendering.
+- MARKETING INDEPENDENCE: Always use a dynamic \`pages\` collection with a catch-all route. Marketing should create pages without a developer. (Exceptions: Special pages like Contact or those with complex forms may use static routes).
+- AUTO-SEEDING: Use \`initialData\` in all data fetches to ensure the site is never empty on first load.
+- Globals use \`client.global(slug).get()\` and \`client.global(slug).update(data)\`.
+- Relationship fields are populated to the specified \`depth\` (default: 1). Set \`depth: 0\` for IDs only.
+- SYNC SCHEMA: After creating the content model, you MUST execute \`npx @dyrected/cli sync:schema\` immediately. This is non-negotiable for a working setup.
+- EMBED ADMIN: You MUST create a route (e.g. \`/admin\`) and mount the Admin UI components described below.
+- ALL-IN-ONE: Your goal is to give the user a project that is READY TO SHIP. Do the setup, do the embedding, and do the sync in one go.
+`;
+  const strategy = `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+PHASE 0 \u2014 DATA PRESERVATION & STRATEGY
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+1. BACKUP: If an existing site is provided, you MUST extract all current content (text, assets, structure) and save it into a \`migration/\` folder as structured .md files BEFORE modifying any code. Never lose data.
+2. DISCOVERY: If NO existing site is provided, STOP and ask the user:
+   - "What are your core content types (e.g. Services, Team, Blog)?"
+   - "How do you want your marketing team to manage the page layouts?"
+3. ARCHITECTURAL CREATIVITY: Design the CMS for longevity. Use \`blocks\` for flexible page builders, \`globals\` for site settings, and \`collections\` for repeated content.
 
-// src/app.ts
-var import_hono = require("hono");
-var import_logger = require("hono/logger");
-var import_cors = require("hono/cors");
-var import_request_id = require("hono/request-id");
+STEP 1 \u2014 CONTENT MODEL (dyrected.config.ts)
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+Use \`defineCollection\`, \`defineGlobal\`, and \`defineConfig\` from '@dyrected/core'.
 
-// src/services/population.service.ts
-var PopulationService = class {
-  constructor(db, collections) {
-    this.db = db;
-    this.collections = collections;
-  }
-  db;
-  collections;
-  /**
-   * Recursively populate relationship fields in a document or array of documents.
-   */
-  async populate(args) {
-    const { data, fields, currentDepth, maxDepth } = args;
-    if (currentDepth >= maxDepth || !data) {
-      return data;
-    }
-    if (Array.isArray(data)) {
-      return Promise.all(data.map((item) => this.populate({ ...args, data: item })));
-    }
-    const populatedDoc = { ...data };
-    for (const field of fields) {
-      const value = populatedDoc[field.name];
-      if (field.type === "relationship" && field.collection && value) {
-        const relatedCollection = this.collections.find((c) => c.slug === field.collection);
-        if (!relatedCollection) continue;
-        if (Array.isArray(value)) {
-          populatedDoc[field.name] = await Promise.all(
-            value.map(async (id) => {
-              const doc = await this.db.findOne({ collection: field.collection, id });
-              if (!doc) return id;
-              return this.populate({
-                data: doc,
-                fields: relatedCollection.fields,
-                currentDepth: currentDepth + 1,
-                maxDepth
-              });
-            })
-          );
-        } else if (typeof value === "string") {
-          const doc = await this.db.findOne({ collection: field.collection, id: value });
-          if (doc) {
-            populatedDoc[field.name] = await this.populate({
-              data: doc,
-              fields: relatedCollection.fields,
-              currentDepth: currentDepth + 1,
-              maxDepth
-            });
-          }
-        }
-      }
-      if ((field.type === "array" || field.type === "object") && field.fields && value) {
-        populatedDoc[field.name] = await this.populate({
-          data: value,
-          fields: field.fields,
-          currentDepth,
-          // Nested fields don't consume depth, only relationships do
-          maxDepth
-        });
-      }
-    }
-    return populatedDoc;
-  }
-  /**
-   * Helper to populate a PaginatedResult
-   */
-  async populateResult(result, fields, maxDepth) {
-    if (maxDepth <= 0) return result;
-    const populatedDocs = await this.populate({
-      data: result.docs,
-      fields,
-      currentDepth: 0,
-      maxDepth
-    });
-    return {
-      ...result,
-      docs: populatedDocs
-    };
-  }
-};
+SUPPORTED FIELD TYPES:
+  Primitive  : text | textarea | richText | number | boolean | date | email | url | json
+  Choice     : select | multiSelect           (requires \`options: [{ label, value }]\`)
+  Structural : array | object                 (requires nested \`fields: [...]\`)
+  Relation   : relationship                   (requires \`collection: '<slug>'\`)
+  Media      : image                          (use a relationship to an upload collection)
+  Blocks     : blocks                         (requires \`blocks: [{ slug, labels, fields }]\`)
 
-// src/controllers/collection.controller.ts
-var CollectionController = class {
-  constructor(collection) {
-    this.collection = collection;
-  }
-  collection;
-  async find(c) {
-    const config = c.get("config");
-    const db = config.db;
-    const limit = Number(c.req.query("limit")) || 10;
-    const page = Number(c.req.query("page")) || 1;
-    const depth = Number(c.req.query("depth")) || 0;
-    let result = await db.find({
-      collection: this.collection.slug,
-      limit,
-      page
-    });
-    if (depth > 0) {
-      const populationService = new PopulationService(db, config.collections);
-      result = await populationService.populateResult(result, this.collection.fields, depth);
-    }
-    return c.json(result);
-  }
-  async findOne(c) {
-    const config = c.get("config");
-    const db = config.db;
-    const id = c.req.param("id");
-    const depth = Number(c.req.query("depth")) || 0;
-    if (!id) return c.json({ message: "Missing ID" }, 400);
-    const doc = await db.findOne({ collection: this.collection.slug, id });
-    if (!doc) return c.json({ message: "Not Found" }, 404);
-    if (depth > 0 && doc) {
-      const populationService = new PopulationService(db, config.collections);
-      const populatedDoc = await populationService.populate({
-        data: doc,
-        fields: this.collection.fields,
-        currentDepth: 0,
-        maxDepth: depth
-      });
-      return c.json(populatedDoc);
-    }
-    return c.json(doc);
-  }
-  async create(c) {
-    const db = c.get("config").db;
-    const body = await c.req.json();
-    const doc = await db.create({ collection: this.collection.slug, data: body });
-    return c.json(doc, 201);
-  }
-  async update(c) {
-    const db = c.get("config").db;
-    const id = c.req.param("id");
-    if (!id) return c.json({ message: "Missing ID" }, 400);
-    const body = await c.req.json();
-    const doc = await db.update({ collection: this.collection.slug, id, data: body });
-    return c.json(doc);
-  }
-  async delete(c) {
-    const db = c.get("config").db;
-    const id = c.req.param("id");
-    if (!id) return c.json({ message: "Missing ID" }, 400);
-    await db.delete({ collection: this.collection.slug, id });
-    return c.json({ message: "Deleted" });
-  }
-};
+COLLECTION OPTIONS:
+  \`upload: true\`   \u2014 turns this collection into a media library (file uploads)
+  \`auth: true\`     \u2014 adds login/register/me endpoints; password field is auto-added
+  \`admin.group\`    \u2014 groups this collection under a sidebar heading
+  \`admin.useAsTitle\` \u2014 field to use as the display title in the admin list view
+  \`admin.hidden\`   \u2014 hide from sidebar (useful for internal/system collections)
 
-// src/controllers/global.controller.ts
-var GlobalController = class {
-  constructor(global) {
-    this.global = global;
-  }
-  global;
-  async get(c) {
-    const config = c.get("config");
-    const db = config.db;
-    const depth = Number(c.req.query("depth")) || 0;
-    const data = await db.getGlobal({ slug: this.global.slug });
-    if (depth > 0 && data) {
-      const populationService = new PopulationService(db, config.collections);
-      const populatedData = await populationService.populate({
-        data,
-        fields: this.global.fields,
-        currentDepth: 0,
-        maxDepth: depth
-      });
-      return c.json(populatedData);
-    }
-    return c.json(data || {});
-  }
-  async update(c) {
-    const db = c.get("config").db;
-    const body = await c.req.json();
-    const data = await db.updateGlobal({ slug: this.global.slug, data: body });
-    return c.json(data);
-  }
-};
+FIELD OPTIONS:
+  \`required\`        \u2014 validation
+  \`unique\`          \u2014 database-level uniqueness
+  \`defaultValue\`    \u2014 fallback value
+  \`admin.condition\` \u2014 "expression" \u2014 Jexl string expression to show/hide field (e.g. "status == \\"published\\"")
+  \`admin.layout\`    \u2014 "radio" | "dropdown" \u2014 Visual layout for select/multiSelect
+  \`admin.direction\` \u2014 "vertical" | "horizontal" \u2014 Layout direction for radio groups
+  \`admin.readOnly\`  \u2014 display-only in the form
+  \`admin.hidden\`    \u2014 completely hidden from editor UI
+  \`access.read\`     \u2014 ({ user }) => boolean \u2014 field-level read access
+  \`access.update\`   \u2014 ({ user }) => boolean \u2014 field-level write access
+  \`hooks.beforeChange\` \u2014 [async (value) => newValue] \u2014 transform value before save
+  \`hooks.afterRead\`    \u2014 [async (value) => newValue] \u2014 transform value after read
 
-// src/controllers/media.controller.ts
-var MediaController = class {
-  async upload(c) {
-    const config = c.get("config");
-    const storage = config.storage;
-    if (!storage) {
-      return c.json({ message: "Storage not configured" }, 500);
-    }
-    const body = await c.req.parseBody();
-    const file = body["file"];
-    if (!file) {
-      return c.json({ message: "No file uploaded" }, 400);
-    }
-    const buffer = Buffer.from(await file.arrayBuffer());
-    const fileData = await storage.upload({
-      filename: file.name,
-      buffer,
-      mimeType: file.type
-    });
-    const db = config.db;
-    const doc = await db.create({
-      collection: "media",
-      data: fileData
-    });
-    return c.json(doc, 201);
-  }
-  async find(c) {
-    const db = c.get("config").db;
-    const limit = Number(c.req.query("limit")) || 10;
-    const page = Number(c.req.query("page")) || 1;
-    const result = await db.find({
-      collection: "media",
-      limit,
-      page
-    });
-    return c.json(result);
-  }
-  async delete(c) {
-    const config = c.get("config");
-    const storage = config.storage;
-    const db = config.db;
-    const id = c.req.param("id");
-    if (!id) return c.json({ message: "Missing ID" }, 400);
-    const doc = await db.findOne({ collection: "media", id });
-    if (!doc) return c.json({ message: "Not Found" }, 404);
-    if (storage) {
-      await storage.delete({ filename: doc.filename });
+BLOCKS EXPLAINED:
+  A \`blocks\` field stores an ordered array of typed content blocks.
+  Each block has a \`blockType\` discriminator and its own set of fields.
+  The admin UI renders a drag-and-drop block editor automatically.
+  On the frontend, iterate the array and switch on \`block.blockType\`.
+
+COMPLETE EXAMPLE:
+\`\`\`typescript
+import { defineCollection, defineGlobal, defineConfig } from '@dyrected/core'
+
+// \u2500\u2500 Media \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const media = defineCollection({
+  slug: 'media',
+  labels: { singular: 'Media Item', plural: 'Media' },
+  upload: true,
+  fields: [
+    { name: 'alt', type: 'text', label: 'Alt Text' },
+    { name: 'caption', type: 'textarea', label: 'Caption' },
+  ],
+})
+
+// \u2500\u2500 Authentication collection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const customers = defineCollection({
+  slug: 'customers',
+  labels: { singular: 'Customer', plural: 'Customers' },
+  auth: true,                  // adds /customers/login, /customers/me, etc.
+  admin: { group: 'Membership' },
+  fields: [
+    { name: 'name', type: 'text', required: true },
+    { name: 'email', type: 'email', required: true, unique: true },
+    // 'password' is auto-added when auth: true
+    { name: 'avatar', type: 'relationship', relationTo: 'media' },
+    { name: 'role', type: 'select', admin: { layout: 'radio' }, options: [
+        { label: 'Member', value: 'member' },
+        { label: 'VIP', value: 'vip' },
+    ]},
+  ],
+})
+
+// \u2500\u2500 Pages with blocks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const pages = defineCollection({
+  slug: 'pages',
+  labels: { singular: 'Page', plural: 'Pages' },
+  admin: { useAsTitle: 'title', group: 'Content' },
+  fields: [
+    { name: 'title', type: 'text', required: true },
+    { name: 'slug',  type: 'text', required: true, unique: true },
+    { name: 'seo', type: 'object', fields: [
+        { name: 'metaTitle',       type: 'text' },
+        { name: 'metaDescription', type: 'textarea' },
+        { name: 'ogImage',         type: 'relationship', relationTo: 'media' },
+    ]},
+    {
+      name: 'layout',
+      type: 'blocks',
+      label: 'Page Layout',
+      blocks: [
+        {
+          slug: 'hero',
+          labels: { singular: 'Hero', plural: 'Heroes' },
+          fields: [
+            { name: 'heading',    type: 'text',         required: true },
+            { name: 'subheading', type: 'textarea' },
+            { name: 'image',      type: 'relationship', relationTo: 'media' },
+            { name: 'ctaLabel',   type: 'text' },
+            { name: 'ctaLink',    type: 'url' },
+          ],
+        },
+        {
+          slug: 'richContent',
+          labels: { singular: 'Rich Content', plural: 'Rich Content Blocks' },
+          fields: [
+            { name: 'content', type: 'richText', required: true },
+          ],
+        },
+      ],
+    },
+  ],
+})
+
+export default defineConfig({
+  collections: [media, customers, pages],
+  admin: {
+    branding: {
+      primaryColor: '#4f46e5',
+      logo: '/logo.png',
     }
-    await db.delete({ collection: "media", id });
-    return c.json({ message: "Deleted" });
   }
-};
+})
+\`\`\`
 
-// src/router.ts
-function registerRoutes(app, config) {
-  app.get("/api/schemas", (c) => {
-    return c.json({
-      collections: config.collections.map((col) => ({
-        slug: col.slug,
-        labels: col.labels,
-        fields: col.fields,
-        auth: col.auth,
-        upload: col.upload
-      })),
-      globals: config.globals.map((glb) => ({
-        slug: glb.slug,
-        label: glb.label,
-        fields: glb.fields
-      }))
-    });
-  });
-  if (config.storage) {
-    const mediaController = new MediaController();
-    app.get("/api/media", (c) => mediaController.find(c));
-    app.post("/api/media", (c) => mediaController.upload(c));
-    app.delete("/api/media/:id", (c) => mediaController.delete(c));
-  }
-  for (const collection of config.collections) {
-    const path = `/api/collections/${collection.slug}`;
-    const controller = new CollectionController(collection);
-    app.get(path, (c) => controller.find(c));
-    app.post(path, (c) => controller.create(c));
-    app.get(`${path}/:id`, (c) => controller.findOne(c));
-    app.patch(`${path}/:id`, (c) => controller.update(c));
-    app.delete(`${path}/:id`, (c) => controller.delete(c));
-  }
-  for (const global of config.globals) {
-    const path = `/api/globals/${global.slug}`;
-    const controller = new GlobalController(global);
-    app.get(path, (c) => controller.get(c));
-    app.patch(path, (c) => controller.update(c));
-  }
-}
+${isSelfHosted ? "" : `
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+STEP 2 \u2014 CHOOSE YOUR MODE
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+The developer can choose between two modes:
 
-// src/app.ts
-function createDyrectedApp(config) {
-  const app = new import_hono.Hono();
-  app.use("*", (0, import_request_id.requestId)());
-  app.use("*", (0, import_logger.logger)());
-  app.use("*", (0, import_cors.cors)());
-  app.use("*", async (c, next) => {
-    c.set("config", config);
-    if (!c.get("siteId")) {
-      c.set("siteId", "default");
-    }
-    await next();
-  });
-  app.get("/health", (c) => c.json({ status: "ok", version: "0.0.1" }));
-  registerRoutes(app, config);
-  return app;
+1. CLOUD MODE (Managed)
+   - Use the SITE CREDENTIALS above.
+   - Point baseUrl to ${config.baseUrl}.
+   - Content is stored in Dyrected Cloud.
+
+2. SELF-HOSTED MODE (Core)
+   - Do NOT use apiKey/siteId (unless for proxying).
+   - Use a database adapter like \`SqliteAdapter\` from '@dyrected/db-sqlite'.
+   - Content is stored locally in the developer's project.
+`}
+
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+STEP ${isSelfHosted ? "2" : "3"} \u2014 MOUNTING THE ADMIN UI
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+The Admin UI can be mounted on any path (e.g. /cms-admin).
+Pass the \`basename\` prop to the \`<AdminUI />\` component to match your route.
+
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+STEP ${isSelfHosted ? "3" : "4"} \u2014 FRONTEND IMPLEMENTATION
+\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
+`;
+  const frameworks = {
+    next: `Install \`@dyrected/sdk\` (or \`@dyrected/next\` if you want Next.js server helpers).
+
+SDK CLIENT SETUP (\`lib/dyrected.ts\`):
+\`\`\`ts
+import { createClient } from '@dyrected/sdk'
+
+export const dyrected = createClient({
+  baseUrl: '${config.baseUrl || "http://localhost:3000"}',${isSelfHosted ? "" : `
+  apiKey:  '${config.apiKey}',
+  siteId:  '${config.siteId}',`}
+})
+\`\`\``,
+    nuxt: `Install \`@dyrected/nuxt\` and add it to \`nuxt.config.ts\`:
+\`\`\`ts
+export default defineNuxtConfig({
+  modules: ['@dyrected/nuxt'],
+  dyrected: {
+    baseUrl: '${config.baseUrl || "http://localhost:3000"}',${isSelfHosted ? "" : `
+    apiKey:  '${config.apiKey}',
+    siteId:  '${config.siteId}',`}
+  },
+})
+\`\`\`
+
+MOUNTING THE ADMIN DASHBOARD (\`pages/cms-admin.vue\`):
+\`\`\`vue
+<script setup lang="ts">
+definePageMeta({ layout: false })
+</script>
+
+<template>
+  <ClientOnly>
+    <DyrectedAdmin basename="/cms-admin" />
+  </ClientOnly>
+</template>
+\`\`\`
+`,
+    react: `Install \`@dyrected/sdk\`:
+
+CLIENT SETUP (\`lib/dyrected.ts\`):
+\`\`\`ts
+import { createClient } from '@dyrected/sdk'
+
+export const dyrected = createClient({
+  baseUrl: '${config.baseUrl || "https://api.dyrected.cloud"}',${isSelfHosted ? "" : `
+  apiKey:  '${config.apiKey}',
+  siteId:  '${config.siteId}',`}
+})
+\`\`\`
+
+MOUNTING THE ADMIN DASHBOARD (\`pages/admin.tsx\`):
+\`\`\`tsx
+import { AdminUI } from '@dyrected/admin'
+import '@dyrected/admin/styles'
+
+export default function AdminPage() {
+  return (
+    <div style={{ height: '100vh' }}>
+      <AdminUI 
+        apiKey='${config.apiKey}'
+        siteId='${config.siteId}'
+        baseUrl='${config.baseUrl || "https://api.dyrected.cloud"}'
+      />
+    </div>
+  )
 }
+\`\`\`
+`,
+    vue: `Install \`@dyrected/sdk\`:
 
-// src/services/media.service.ts
-var MediaService = class {
-  /**
-   * Fetches metadata for a given URL.
-   * Supports YouTube and Vimeo.
-   */
-  static async fetchMetadata(url) {
-    if (!url) return null;
-    if (url.includes("youtube.com") || url.includes("youtu.be")) {
-      const videoId = this.extractYoutubeId(url);
-      if (videoId) {
-        return {
-          provider: "youtube",
-          provider_id: videoId,
-          thumbnail: `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`,
-          embedUrl: `https://www.youtube.com/embed/${videoId}`,
-          type: "video"
-        };
-      }
-    }
-    if (url.includes("vimeo.com")) {
-      const vimeoId = this.extractVimeoId(url);
-      if (vimeoId) {
-        return {
-          provider: "vimeo",
-          provider_id: vimeoId,
-          thumbnail: "",
-          // Requires oEmbed API for reliable thumbnails
-          embedUrl: `https://player.vimeo.com/video/${vimeoId}`,
-          type: "video"
-        };
-      }
-    }
-    return null;
-  }
-  static extractYoutubeId(url) {
-    const regExp = /^.*(youtu.be\/|v\/|u\/\w\/|embed\/|watch\?v=|\&v=)([^#\&\?]*).*/;
-    const match = url.match(regExp);
-    return match && match[2].length === 11 ? match[2] : null;
-  }
-  static extractVimeoId(url) {
-    const match = url.match(/vimeo.com\/(?:channels\/(?:\w+\/)?|groups\/(?:[^\/]*)\/videos\/|album\/(?:\d+)\/video\/|video\/|)(\d+)(?:$|\/|\?)/);
-    return match ? match[1] : null;
-  }
-};
+CLIENT SETUP (\`lib/dyrected.ts\`):
+\`\`\`ts
+import { createClient } from '@dyrected/sdk'
+
+export const dyrected = createClient({
+  baseUrl: '${config.baseUrl || "https://api.dyrected.cloud"}',${isSelfHosted ? "" : `
+  apiKey:  '${config.apiKey}',
+  siteId:  '${config.siteId}',`}
+})
+\`\`\`
+
+MOUNTING THE ADMIN DASHBOARD (\`pages/admin.vue\`):
+\`\`\`vue
+<template>
+  <div ref="container" style="height: 100vh" />
+</template>
+
+<script setup>
+import { ref, onMounted } from 'vue'
+import { renderAdminUI } from '@dyrected/admin'
+import '@dyrected/admin/styles'
+
+const container = ref(null)
+onMounted(() => {
+  renderAdminUI(container.value, {
+    apiKey: '${config.apiKey}',
+    siteId: '${config.siteId}',
+    baseUrl: '${config.baseUrl || "https://api.dyrected.cloud"}'
+  })
+})
+</script>
+\`\`\`
+`
+  };
+  return baseIntro + credentials + importantNotes + strategy + (frameworks[activeTab] || frameworks.next) + `
+
+  API Reference: ${config.baseUrl || "http://localhost:3000"}/api/docs`;
+}
 
 // src/index.ts
 function defineCollection(config) {
@@ -380,12 +314,10 @@ function defineGlobal(config) {
 function defineConfig(config) {
   return config;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MediaService,
-  PopulationService,
-  createDyrectedApp,
+export {
   defineCollection,
   defineConfig,
-  defineGlobal
-});
+  defineGlobal,
+  generateAIPrompt,
+  normalizeConfig
+};