@imjp/writenex-astro 0.1.0

package/dist/filesystem/index.js

@@ -0,0 +1,203 @@
+import {
+  ContentWatcher,
+  FileModificationTracker,
+  createContentWatcher
+} from "../chunk-XNTQTTJU.js";
+import {
+  DEFAULT_IMAGE_CONFIG,
+  calculateRelativePath,
+  clearVersions,
+  createContent,
+  createEmptyManifest,
+  deleteContent,
+  deleteVersion,
+  detectContentStructure,
+  discoverContentImages,
+  ensureGitignore,
+  ensureStorageDirectory,
+  generatePreview,
+  generateSlug,
+  generateUniqueSlug,
+  generateVersionId,
+  getContentImageFolder,
+  getManifestPath,
+  getOrRecoverManifest,
+  getVersion,
+  getVersionFilePath,
+  getVersionStoragePath,
+  getVersions,
+  isValidImageFile,
+  parseMultipartFormData,
+  parseVersionId,
+  pruneVersions,
+  readManifest,
+  recoverManifest,
+  restoreVersion,
+  saveVersion,
+  scanDirectoryForImages,
+  updateContent,
+  uploadImage,
+  writeManifest
+} from "../chunk-CF2XXJFF.js";
+import {
+  checkCollection,
+  extractSlug,
+  generateExcerpt,
+  getCollectionCount,
+  getCollectionSummaries,
+  getContentFilePath,
+  getFileStats,
+  isContentFile,
+  readCollection,
+  readContentFile,
+  toContentSummary
+} from "../chunk-AAOQHQPU.js";
+import {
+  DEFAULT_VERSION_HISTORY_CONFIG
+} from "../chunk-CRPZUUDU.js";
+
+// src/filesystem/version-config.ts
+function resolveVersionConfig(config) {
+  if (!config) {
+    return { ...DEFAULT_VERSION_HISTORY_CONFIG };
+  }
+  return {
+    enabled: config.enabled ?? DEFAULT_VERSION_HISTORY_CONFIG.enabled,
+    maxVersions: config.maxVersions ?? DEFAULT_VERSION_HISTORY_CONFIG.maxVersions,
+    storagePath: config.storagePath ?? DEFAULT_VERSION_HISTORY_CONFIG.storagePath
+  };
+}
+function isVersionHistoryEnabled(config) {
+  const resolved = resolveVersionConfig(config);
+  return resolved.enabled;
+}
+async function saveVersionWithConfig(projectRoot, collection, contentId, content, config, options) {
+  const resolvedConfig = resolveVersionConfig(config);
+  if (!resolvedConfig.enabled) {
+    return { success: true };
+  }
+  return saveVersion(
+    projectRoot,
+    collection,
+    contentId,
+    content,
+    resolvedConfig,
+    options
+  );
+}
+async function getVersionsWithConfig(projectRoot, collection, contentId, config) {
+  const resolvedConfig = resolveVersionConfig(config);
+  if (!resolvedConfig.enabled) {
+    return [];
+  }
+  return getVersions(projectRoot, collection, contentId, resolvedConfig);
+}
+async function getVersionWithConfig(projectRoot, collection, contentId, versionId, config) {
+  const resolvedConfig = resolveVersionConfig(config);
+  if (!resolvedConfig.enabled) {
+    return null;
+  }
+  return getVersion(
+    projectRoot,
+    collection,
+    contentId,
+    versionId,
+    resolvedConfig
+  );
+}
+async function deleteVersionWithConfig(projectRoot, collection, contentId, versionId, config) {
+  const resolvedConfig = resolveVersionConfig(config);
+  return deleteVersion(
+    projectRoot,
+    collection,
+    contentId,
+    versionId,
+    resolvedConfig
+  );
+}
+async function clearVersionsWithConfig(projectRoot, collection, contentId, config) {
+  const resolvedConfig = resolveVersionConfig(config);
+  return clearVersions(projectRoot, collection, contentId, resolvedConfig);
+}
+async function pruneVersionsWithConfig(projectRoot, collection, contentId, config) {
+  const resolvedConfig = resolveVersionConfig(config);
+  return pruneVersions(projectRoot, collection, contentId, resolvedConfig);
+}
+async function restoreVersionWithConfig(projectRoot, collection, contentId, versionId, contentFilePath, config, options) {
+  const resolvedConfig = resolveVersionConfig(config);
+  if (!resolvedConfig.enabled) {
+    return {
+      success: false,
+      error: "Version history is disabled"
+    };
+  }
+  return restoreVersion(
+    projectRoot,
+    collection,
+    contentId,
+    versionId,
+    contentFilePath,
+    resolvedConfig,
+    options
+  );
+}
+export {
+  ContentWatcher,
+  DEFAULT_IMAGE_CONFIG,
+  FileModificationTracker,
+  calculateRelativePath,
+  checkCollection,
+  clearVersions,
+  clearVersionsWithConfig,
+  createContent,
+  createContentWatcher,
+  createEmptyManifest,
+  deleteContent,
+  deleteVersion,
+  deleteVersionWithConfig,
+  detectContentStructure,
+  discoverContentImages,
+  ensureGitignore,
+  ensureStorageDirectory,
+  extractSlug,
+  generateExcerpt,
+  generatePreview,
+  generateSlug,
+  generateUniqueSlug,
+  generateVersionId,
+  getCollectionCount,
+  getCollectionSummaries,
+  getContentFilePath,
+  getContentImageFolder,
+  getFileStats,
+  getManifestPath,
+  getOrRecoverManifest,
+  getVersion,
+  getVersionFilePath,
+  getVersionStoragePath,
+  getVersionWithConfig,
+  getVersions,
+  getVersionsWithConfig,
+  isContentFile,
+  isValidImageFile,
+  isVersionHistoryEnabled,
+  parseMultipartFormData,
+  parseVersionId,
+  pruneVersions,
+  pruneVersionsWithConfig,
+  readCollection,
+  readContentFile,
+  readManifest,
+  recoverManifest,
+  resolveVersionConfig,
+  restoreVersion,
+  restoreVersionWithConfig,
+  saveVersion,
+  saveVersionWithConfig,
+  scanDirectoryForImages,
+  toContentSummary,
+  updateContent,
+  uploadImage,
+  writeManifest
+};
+//# sourceMappingURL=index.js.map

package/dist/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/filesystem/version-config.ts"],"sourcesContent":["/**\n * @fileoverview Config-aware wrappers for version history operations\n *\n * This module provides wrapper functions that automatically apply configuration\n * defaults and check the enabled flag before performing version operations.\n * These wrappers simplify usage by accepting partial configuration and handling\n * all the configuration resolution internally.\n *\n * @module @writenex/astro/filesystem/version-config\n * @see {@link saveVersion} - Core save function\n * @see {@link getVersions} - Core list function\n */\n\nimport type {\n  VersionHistoryConfig,\n  VersionEntry,\n  Version,\n  VersionResult,\n  SaveVersionOptions,\n  RestoreVersionOptions,\n  RestoreResult,\n} from \"@/types\";\nimport { DEFAULT_VERSION_HISTORY_CONFIG } from \"@/config/defaults\";\nimport {\n  saveVersion as coreSaveVersion,\n  getVersions as coreGetVersions,\n  getVersion as coreGetVersion,\n  deleteVersion as coreDeleteVersion,\n  clearVersions as coreClearVersions,\n  pruneVersions as corePruneVersions,\n  restoreVersion as coreRestoreVersion,\n} from \"./versions\";\n\n// =============================================================================\n// Configuration Resolution\n// =============================================================================\n\n/**\n * Resolve version history configuration with defaults applied.\n *\n * Takes a partial configuration and merges it with defaults to produce\n * a complete configuration object.\n *\n * @param config - Partial version history configuration\n * @returns Complete configuration with all defaults applied\n *\n * @example\n * ```typescript\n * const resolved = resolveVersionConfig({ maxVersions: 50 });\n * // Returns: { enabled: true, maxVersions: 50, storagePath: '.writenex/versions' }\n * ```\n */\nexport function resolveVersionConfig(\n  config?: VersionHistoryConfig\n): Required<VersionHistoryConfig> {\n  if (!config) {\n    return { ...DEFAULT_VERSION_HISTORY_CONFIG };\n  }\n\n  return {\n    enabled: config.enabled ?? DEFAULT_VERSION_HISTORY_CONFIG.enabled,\n    maxVersions:\n      config.maxVersions ?? DEFAULT_VERSION_HISTORY_CONFIG.maxVersions,\n    storagePath:\n      config.storagePath ?? DEFAULT_VERSION_HISTORY_CONFIG.storagePath,\n  };\n}\n\n/**\n * Check if version history is enabled in the configuration.\n *\n * @param config - Version history configuration (partial or full)\n * @returns True if version history is enabled\n *\n * @example\n * ```typescript\n * if (isVersionHistoryEnabled({ enabled: false })) {\n *   // This won't execute\n * }\n * ```\n */\nexport function isVersionHistoryEnabled(\n  config?: VersionHistoryConfig\n): boolean {\n  const resolved = resolveVersionConfig(config);\n  return resolved.enabled;\n}\n\n// =============================================================================\n// Config-Aware Version Operations\n// =============================================================================\n\n/**\n * Save a version with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults and checks\n * the enabled flag before delegating to the core saveVersion function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param content - Full markdown content to save\n * @param config - Partial version history configuration\n * @param options - Save options\n * @returns Result of the save operation\n *\n * @example\n * ```typescript\n * // With partial config - defaults are applied automatically\n * const result = await saveVersionWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   '---\\ntitle: My Post\\n---\\n\\nContent...',\n *   { maxVersions: 50 }  // enabled and storagePath use defaults\n * );\n * ```\n */\nexport async function saveVersionWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  content: string,\n  config?: VersionHistoryConfig,\n  options?: SaveVersionOptions\n): Promise<VersionResult> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  // Early return if disabled\n  if (!resolvedConfig.enabled) {\n    return { success: true };\n  }\n\n  return coreSaveVersion(\n    projectRoot,\n    collection,\n    contentId,\n    content,\n    resolvedConfig,\n    options\n  );\n}\n\n/**\n * Get all versions with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults and checks\n * the enabled flag before delegating to the core getVersions function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param config - Partial version history configuration\n * @returns Array of version entries (empty if disabled)\n *\n * @example\n * ```typescript\n * const versions = await getVersionsWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   { storagePath: 'custom/versions' }\n * );\n * ```\n */\nexport async function getVersionsWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  config?: VersionHistoryConfig\n): Promise<VersionEntry[]> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  // Early return if disabled\n  if (!resolvedConfig.enabled) {\n    return [];\n  }\n\n  return coreGetVersions(projectRoot, collection, contentId, resolvedConfig);\n}\n\n/**\n * Get a specific version with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults and checks\n * the enabled flag before delegating to the core getVersion function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param versionId - Version ID to retrieve\n * @param config - Partial version history configuration\n * @returns Full version data or null if not found/disabled\n *\n * @example\n * ```typescript\n * const version = await getVersionWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   '2024-12-11T10-30-00-000Z'\n * );\n * ```\n */\nexport async function getVersionWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  versionId: string,\n  config?: VersionHistoryConfig\n): Promise<Version | null> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  // Early return if disabled\n  if (!resolvedConfig.enabled) {\n    return null;\n  }\n\n  return coreGetVersion(\n    projectRoot,\n    collection,\n    contentId,\n    versionId,\n    resolvedConfig\n  );\n}\n\n/**\n * Delete a version with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults before\n * delegating to the core deleteVersion function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param versionId - Version ID to delete\n * @param config - Partial version history configuration\n * @returns Result of the delete operation\n *\n * @example\n * ```typescript\n * const result = await deleteVersionWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   '2024-12-11T10-30-00-000Z'\n * );\n * ```\n */\nexport async function deleteVersionWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  versionId: string,\n  config?: VersionHistoryConfig\n): Promise<VersionResult> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  return coreDeleteVersion(\n    projectRoot,\n    collection,\n    contentId,\n    versionId,\n    resolvedConfig\n  );\n}\n\n/**\n * Clear all versions with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults before\n * delegating to the core clearVersions function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param config - Partial version history configuration\n * @returns Result of the clear operation\n *\n * @example\n * ```typescript\n * const result = await clearVersionsWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post'\n * );\n * ```\n */\nexport async function clearVersionsWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  config?: VersionHistoryConfig\n): Promise<VersionResult> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  return coreClearVersions(projectRoot, collection, contentId, resolvedConfig);\n}\n\n/**\n * Prune old versions with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults before\n * delegating to the core pruneVersions function. Uses the configured\n * maxVersions value for determining how many versions to keep.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param config - Partial version history configuration\n * @returns Result of the prune operation\n *\n * @example\n * ```typescript\n * // Uses custom maxVersions\n * const result = await pruneVersionsWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   { maxVersions: 10 }\n * );\n * ```\n */\nexport async function pruneVersionsWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  config?: VersionHistoryConfig\n): Promise<VersionResult> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  return corePruneVersions(projectRoot, collection, contentId, resolvedConfig);\n}\n\n/**\n * Restore a version with automatic configuration resolution.\n *\n * This wrapper automatically applies configuration defaults and checks\n * the enabled flag before delegating to the core restoreVersion function.\n *\n * @param projectRoot - Absolute path to project root\n * @param collection - Collection name\n * @param contentId - Content item ID (slug)\n * @param versionId - Version ID to restore\n * @param contentFilePath - Absolute path to the current content file\n * @param config - Partial version history configuration\n * @param options - Restore options\n * @returns Result of the restore operation\n *\n * @example\n * ```typescript\n * const result = await restoreVersionWithConfig(\n *   '/project',\n *   'blog',\n *   'my-post',\n *   '2024-12-11T10-30-00-000Z',\n *   '/project/src/content/blog/my-post.md'\n * );\n * ```\n */\nexport async function restoreVersionWithConfig(\n  projectRoot: string,\n  collection: string,\n  contentId: string,\n  versionId: string,\n  contentFilePath: string,\n  config?: VersionHistoryConfig,\n  options?: RestoreVersionOptions\n): Promise<RestoreResult> {\n  const resolvedConfig = resolveVersionConfig(config);\n\n  // Early return if disabled\n  if (!resolvedConfig.enabled) {\n    return {\n      success: false,\n      error: \"Version history is disabled\",\n    };\n  }\n\n  return coreRestoreVersion(\n    projectRoot,\n    collection,\n    contentId,\n    versionId,\n    contentFilePath,\n    resolvedConfig,\n    options\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDO,SAAS,qBACd,QACgC;AAChC,MAAI,CAAC,QAAQ;AACX,WAAO,EAAE,GAAG,+BAA+B;AAAA,EAC7C;AAEA,SAAO;AAAA,IACL,SAAS,OAAO,WAAW,+BAA+B;AAAA,IAC1D,aACE,OAAO,eAAe,+BAA+B;AAAA,IACvD,aACE,OAAO,eAAe,+BAA+B;AAAA,EACzD;AACF;AAeO,SAAS,wBACd,QACS;AACT,QAAM,WAAW,qBAAqB,MAAM;AAC5C,SAAO,SAAS;AAClB;AAgCA,eAAsB,sBACpB,aACA,YACA,WACA,SACA,QACA,SACwB;AACxB,QAAM,iBAAiB,qBAAqB,MAAM;AAGlD,MAAI,CAAC,eAAe,SAAS;AAC3B,WAAO,EAAE,SAAS,KAAK;AAAA,EACzB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAwBA,eAAsB,sBACpB,aACA,YACA,WACA,QACyB;AACzB,QAAM,iBAAiB,qBAAqB,MAAM;AAGlD,MAAI,CAAC,eAAe,SAAS;AAC3B,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,YAAgB,aAAa,YAAY,WAAW,cAAc;AAC3E;AAyBA,eAAsB,qBACpB,aACA,YACA,WACA,WACA,QACyB;AACzB,QAAM,iBAAiB,qBAAqB,MAAM;AAGlD,MAAI,CAAC,eAAe,SAAS;AAC3B,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAyBA,eAAsB,wBACpB,aACA,YACA,WACA,WACA,QACwB;AACxB,QAAM,iBAAiB,qBAAqB,MAAM;AAElD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAuBA,eAAsB,wBACpB,aACA,YACA,WACA,QACwB;AACxB,QAAM,iBAAiB,qBAAqB,MAAM;AAElD,SAAO,cAAkB,aAAa,YAAY,WAAW,cAAc;AAC7E;AA0BA,eAAsB,wBACpB,aACA,YACA,WACA,QACwB;AACxB,QAAM,iBAAiB,qBAAqB,MAAM;AAElD,SAAO,cAAkB,aAAa,YAAY,WAAW,cAAc;AAC7E;AA4BA,eAAsB,yBACpB,aACA,YACA,WACA,WACA,iBACA,QACA,SACwB;AACxB,QAAM,iBAAiB,qBAAqB,MAAM;AAGlD,MAAI,CAAC,eAAe,SAAS;AAC3B,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/image-FP7w5ZIs.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Image-related type definitions for @writenex/astro
+ *
+ * This file contains all TypeScript type definitions related to image discovery
+ * and image metadata.
+ *
+ * @module @writenex/astro/types/image
+ */
+/**
+ * Discovered image metadata
+ *
+ * Represents an image file found during content folder scanning.
+ */
+interface DiscoveredImage {
+    /** Original filename (e.g., "hero.jpg") */
+    filename: string;
+    /** Relative path for markdown (e.g., "./images/hero.jpg") */
+    relativePath: string;
+    /** Absolute filesystem path */
+    absolutePath: string;
+    /** File size in bytes */
+    size: number;
+    /** File extension (lowercase, with dot, e.g., ".jpg") */
+    extension: string;
+}
+/**
+ * Options for image discovery
+ */
+interface ImageDiscoveryOptions {
+    /** Maximum recursion depth (default: 5) */
+    maxDepth?: number;
+    /** Additional extensions to include beyond defaults */
+    additionalExtensions?: string[];
+}
+/**
+ * Result of image discovery operation
+ */
+interface ImageDiscoveryResult {
+    /** Whether discovery was successful */
+    success: boolean;
+    /** Discovered images */
+    images: DiscoveredImage[];
+    /** Error message if failed */
+    error?: string;
+}
+
+export type { DiscoveredImage as D, ImageDiscoveryOptions as I, ImageDiscoveryResult as a };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { AstroIntegration } from 'astro';
+import { W as WritenexOptions } from './config-BmEdBDo_.js';
+export { C as CollectionConfig, b as CollectionSchema, D as DiscoveryConfig, E as EditorConfig, F as FieldType, I as ImageConfig, c as ImageStrategy, S as SchemaField, V as VersionHistoryConfig, a as WritenexConfig } from './config-BmEdBDo_.js';
+export { d as defineConfig, l as loadConfig, v as validateConfig } from './loader-CrdnaAWR.js';
+export { C as ContentItem, a as ContentSummary, D as DiscoveredCollection } from './content-BWR52vD-.js';
+export { W as WritenexError, a as WritenexErrorCode, i as isWritenexError } from './errors-C0iYiDTv.js';
+import 'zod';
+
+/**
+ * @fileoverview Astro integration for Writenex visual editor
+ *
+ * This module provides the main Astro integration that injects the Writenex
+ * editor UI and API routes into an Astro project.
+ *
+ * ## Features:
+ * - Injects editor UI at /_writenex
+ * - Provides API routes for content CRUD operations
+ * - Auto-discovers content collections
+ * - Production guard to prevent accidental exposure
+ *
+ * ## Usage:
+ * ```typescript
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import writenex from '@writenex/astro';
+ *
+ * export default defineConfig({
+ *   integrations: [writenex()],
+ * });
+ * ```
+ *
+ * @module @writenex/astro/integration
+ */
+
+/**
+ * Creates the Writenex Astro integration.
+ *
+ * This integration injects the Writenex visual editor into your Astro project,
+ * providing a WYSIWYG interface for editing content collections.
+ *
+ * @param options - Integration options
+ * @param options.allowProduction - Allow running in production (default: false)
+ * @returns Astro integration object
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * export default defineConfig({
+ *   integrations: [writenex()],
+ * });
+ *
+ * // With options
+ * export default defineConfig({
+ *   integrations: [
+ *     writenex({
+ *       allowProduction: true,  // Enable in production (use with caution)
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function writenex(options?: WritenexOptions): AstroIntegration;
+
+export { WritenexOptions, writenex as default, writenex };

package/dist/index.js

@@ -0,0 +1,151 @@
+import "./chunk-KIKIPIFA.js";
+import {
+  ContentWatcher
+} from "./chunk-XNTQTTJU.js";
+import {
+  createMiddleware,
+  getCache
+} from "./chunk-7XU5X6CW.js";
+import "./chunk-CYLDJ3HZ.js";
+import {
+  WritenexError,
+  WritenexErrorCode,
+  isWritenexError
+} from "./chunk-CF2XXJFF.js";
+import "./chunk-AAOQHQPU.js";
+import {
+  defineConfig,
+  loadConfig,
+  validateConfig
+} from "./chunk-5PM6EQE5.js";
+import "./chunk-CRPZUUDU.js";
+
+// src/integration.ts
+var DEFAULT_BASE_PATH = "/_writenex";
+var PACKAGE_NAME = "@writenex/astro";
+function writenex(options) {
+  const { allowProduction = false } = options ?? {};
+  const basePath = DEFAULT_BASE_PATH;
+  let isActive = true;
+  let resolvedConfig = null;
+  let projectRoot = "";
+  let astroTrailingSlash = "ignore";
+  let watcher = null;
+  let hasLoggedEditorUrl = false;
+  return {
+    name: PACKAGE_NAME,
+    hooks: {
+      /**
+       * Configuration setup hook
+       *
+       * This hook runs during Astro's config resolution phase.
+       * We use it to:
+       * 1. Check if we should run (production guard)
+       * 2. Load Writenex configuration
+       * 3. Register any necessary Vite plugins
+       */
+      "astro:config:setup": async ({ command, logger, config }) => {
+        if (command === "build" && !allowProduction) {
+          logger.warn(
+            "Disabled in production build. Use allowProduction: true to override."
+          );
+          isActive = false;
+          return;
+        }
+        projectRoot = config.root.pathname;
+        astroTrailingSlash = config.trailingSlash ?? "ignore";
+        const { config: loadedConfig, warnings } = await loadConfig(projectRoot);
+        resolvedConfig = loadedConfig;
+        for (const warning of warnings) {
+          logger.warn(warning);
+        }
+      },
+      /**
+       * Server setup hook
+       *
+       * This hook runs when the Astro dev server starts.
+       * We use it to:
+       * 1. Inject middleware for API routes
+       * 2. Serve the editor UI
+       * 3. Start file watcher for cache invalidation
+       */
+      "astro:server:setup": ({ server }) => {
+        if (!isActive || !resolvedConfig) {
+          return;
+        }
+        const middleware = createMiddleware({
+          basePath,
+          projectRoot,
+          config: resolvedConfig,
+          trailingSlash: astroTrailingSlash
+        });
+        server.middlewares.use(middleware);
+        const cache = getCache({ hasWatcher: true });
+        watcher = new ContentWatcher(projectRoot, "src/content", {
+          onChange: (event) => {
+            cache.handleFileChange(event.type, event.collection);
+          }
+        });
+        watcher.start();
+      },
+      /**
+       * Server start hook
+       *
+       * This hook runs after the dev server has started and is listening.
+       * We use it to log the full editor URL with the actual server address.
+       */
+      "astro:server:start": ({ address, logger }) => {
+        if (!isActive || hasLoggedEditorUrl) {
+          return;
+        }
+        const protocol = "http";
+        const rawHost = address.address;
+        const isLoopback = rawHost === "" || rawHost === "::" || rawHost === "127.0.0.1" || rawHost === "::1";
+        const host = isLoopback ? "localhost" : rawHost;
+        const port = address.port;
+        const editorUrl = `${protocol}://${host}:${port}${basePath}`;
+        logger.info(`Writenex editor running at: ${editorUrl}`);
+        hasLoggedEditorUrl = true;
+      },
+      /**
+       * Server done hook
+       *
+       * This hook runs when the server is shutting down.
+       * We use it to clean up the file watcher.
+       */
+      "astro:server:done": async () => {
+        if (watcher) {
+          await watcher.stop();
+          watcher = null;
+        }
+      },
+      /**
+       * Build done hook
+       *
+       * This hook runs after the build completes.
+       * Currently just logs a warning if production mode is enabled.
+       */
+      "astro:build:done": ({ logger }) => {
+        if (allowProduction) {
+          logger.warn(
+            "Production mode enabled. Ensure your deployment is secured."
+          );
+        }
+      }
+    }
+  };
+}
+
+// src/core/constants.ts
+var MAX_IMAGE_SIZE = 10 * 1024 * 1024;
+export {
+  WritenexError,
+  WritenexErrorCode,
+  writenex as default,
+  defineConfig,
+  isWritenexError,
+  loadConfig,
+  validateConfig,
+  writenex
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/integration.ts","../src/core/constants.ts"],"sourcesContent":["/**\n * @fileoverview Astro integration for Writenex visual editor\n *\n * This module provides the main Astro integration that injects the Writenex\n * editor UI and API routes into an Astro project.\n *\n * ## Features:\n * - Injects editor UI at /_writenex\n * - Provides API routes for content CRUD operations\n * - Auto-discovers content collections\n * - Production guard to prevent accidental exposure\n *\n * ## Usage:\n * ```typescript\n * // astro.config.mjs\n * import { defineConfig } from 'astro/config';\n * import writenex from '@writenex/astro';\n *\n * export default defineConfig({\n *   integrations: [writenex()],\n * });\n * ```\n *\n * @module @writenex/astro/integration\n */\n\nimport type { AstroIntegration } from \"astro\";\nimport type { WritenexOptions, WritenexConfig } from \"@/types\";\nimport { loadConfig } from \"@/config/loader\";\nimport { createMiddleware } from \"@/server/middleware\";\nimport { ContentWatcher } from \"@/filesystem/watcher\";\nimport { getCache } from \"@/server/cache\";\n\n/**\n * Default base path for the Writenex editor UI\n */\nconst DEFAULT_BASE_PATH = \"/_writenex\";\n\n/**\n * Package name for logging\n */\nconst PACKAGE_NAME = \"@writenex/astro\";\n\n/**\n * Creates the Writenex Astro integration.\n *\n * This integration injects the Writenex visual editor into your Astro project,\n * providing a WYSIWYG interface for editing content collections.\n *\n * @param options - Integration options\n * @param options.allowProduction - Allow running in production (default: false)\n * @returns Astro integration object\n *\n * @example\n * ```typescript\n * // Basic usage\n * export default defineConfig({\n *   integrations: [writenex()],\n * });\n *\n * // With options\n * export default defineConfig({\n *   integrations: [\n *     writenex({\n *       allowProduction: true,  // Enable in production (use with caution)\n *     }),\n *   ],\n * });\n * ```\n */\nexport default function writenex(options?: WritenexOptions): AstroIntegration {\n  const { allowProduction = false } = options ?? {};\n\n  // Use fixed base path for consistency and branding\n  const basePath = DEFAULT_BASE_PATH;\n\n  // Track if we should be active\n  let isActive = true;\n\n  // Store loaded configuration\n  let resolvedConfig: Required<WritenexConfig> | null = null;\n\n  // Store project root\n  let projectRoot = \"\";\n\n  // Store Astro's trailingSlash setting\n  let astroTrailingSlash: \"always\" | \"never\" | \"ignore\" = \"ignore\";\n\n  // File watcher instance\n  let watcher: ContentWatcher | null = null;\n\n  // Track if editor URL has been logged (to avoid duplicate logs)\n  let hasLoggedEditorUrl = false;\n\n  return {\n    name: PACKAGE_NAME,\n    hooks: {\n      /**\n       * Configuration setup hook\n       *\n       * This hook runs during Astro's config resolution phase.\n       * We use it to:\n       * 1. Check if we should run (production guard)\n       * 2. Load Writenex configuration\n       * 3. Register any necessary Vite plugins\n       */\n      \"astro:config:setup\": async ({ command, logger, config }) => {\n        // Production guard: disable in production unless explicitly allowed\n        if (command === \"build\" && !allowProduction) {\n          logger.warn(\n            \"Disabled in production build. Use allowProduction: true to override.\"\n          );\n          isActive = false;\n          return;\n        }\n\n        // Store project root\n        projectRoot = config.root.pathname;\n\n        // Capture Astro's trailingSlash setting for preview URLs\n        astroTrailingSlash = config.trailingSlash ?? \"ignore\";\n\n        // Load Writenex configuration\n        const { config: loadedConfig, warnings } =\n          await loadConfig(projectRoot);\n        resolvedConfig = loadedConfig;\n\n        // Log any configuration warnings\n        for (const warning of warnings) {\n          logger.warn(warning);\n        }\n      },\n\n      /**\n       * Server setup hook\n       *\n       * This hook runs when the Astro dev server starts.\n       * We use it to:\n       * 1. Inject middleware for API routes\n       * 2. Serve the editor UI\n       * 3. Start file watcher for cache invalidation\n       */\n      \"astro:server:setup\": ({ server }) => {\n        // Skip if disabled (production guard triggered)\n        if (!isActive || !resolvedConfig) {\n          return;\n        }\n\n        // Create and register the middleware\n        const middleware = createMiddleware({\n          basePath,\n          projectRoot,\n          config: resolvedConfig,\n          trailingSlash: astroTrailingSlash,\n        });\n\n        server.middlewares.use(middleware);\n\n        // Setup cache with file watcher integration\n        const cache = getCache({ hasWatcher: true });\n\n        // Start file watcher for cache invalidation\n        watcher = new ContentWatcher(projectRoot, \"src/content\", {\n          onChange: (event) => {\n            cache.handleFileChange(event.type, event.collection);\n          },\n        });\n\n        watcher.start();\n      },\n\n      /**\n       * Server start hook\n       *\n       * This hook runs after the dev server has started and is listening.\n       * We use it to log the full editor URL with the actual server address.\n       */\n      \"astro:server:start\": ({ address, logger }) => {\n        if (!isActive || hasLoggedEditorUrl) {\n          return;\n        }\n\n        // Build the full URL from the server address\n        // Normalize loopback addresses to \"localhost\" for better readability\n        const protocol = \"http\";\n        const rawHost = address.address;\n        const isLoopback =\n          rawHost === \"\" ||\n          rawHost === \"::\" ||\n          rawHost === \"127.0.0.1\" ||\n          rawHost === \"::1\";\n        const host = isLoopback ? \"localhost\" : rawHost;\n        const port = address.port;\n        const editorUrl = `${protocol}://${host}:${port}${basePath}`;\n\n        logger.info(`Writenex editor running at: ${editorUrl}`);\n        hasLoggedEditorUrl = true;\n      },\n\n      /**\n       * Server done hook\n       *\n       * This hook runs when the server is shutting down.\n       * We use it to clean up the file watcher.\n       */\n      \"astro:server:done\": async () => {\n        if (watcher) {\n          await watcher.stop();\n          watcher = null;\n        }\n      },\n\n      /**\n       * Build done hook\n       *\n       * This hook runs after the build completes.\n       * Currently just logs a warning if production mode is enabled.\n       */\n      \"astro:build:done\": ({ logger }) => {\n        if (allowProduction) {\n          logger.warn(\n            \"Production mode enabled. Ensure your deployment is secured.\"\n          );\n        }\n      },\n    },\n  };\n}\n","/**\n * @fileoverview Shared constants for @writenex/astro\n *\n * This module provides centralized constants used across the integration,\n * including version information, default paths, and configuration limits.\n *\n * @module @writenex/astro/core/constants\n */\n\n/**\n * Current version of the @writenex/astro package\n */\nexport const WRITENEX_VERSION = \"1.0.0\";\n\n/**\n * Default base path for the Writenex editor UI\n */\nexport const DEFAULT_BASE_PATH = \"/_writenex\";\n\n/**\n * Default API path for Writenex API endpoints\n */\nexport const DEFAULT_API_PATH = \"/_writenex/api\";\n\n/**\n * Supported image MIME types for upload\n */\nexport const SUPPORTED_IMAGE_TYPES = [\n  \"image/jpeg\",\n  \"image/png\",\n  \"image/gif\",\n  \"image/webp\",\n  \"image/svg+xml\",\n] as const;\n\n/**\n * Maximum allowed image file size in bytes (10MB)\n */\nexport const MAX_IMAGE_SIZE = 10 * 1024 * 1024;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoCA,IAAM,oBAAoB;AAK1B,IAAM,eAAe;AA6BN,SAAR,SAA0B,SAA6C;AAC5E,QAAM,EAAE,kBAAkB,MAAM,IAAI,WAAW,CAAC;AAGhD,QAAM,WAAW;AAGjB,MAAI,WAAW;AAGf,MAAI,iBAAkD;AAGtD,MAAI,cAAc;AAGlB,MAAI,qBAAoD;AAGxD,MAAI,UAAiC;AAGrC,MAAI,qBAAqB;AAEzB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAUL,sBAAsB,OAAO,EAAE,SAAS,QAAQ,OAAO,MAAM;AAE3D,YAAI,YAAY,WAAW,CAAC,iBAAiB;AAC3C,iBAAO;AAAA,YACL;AAAA,UACF;AACA,qBAAW;AACX;AAAA,QACF;AAGA,sBAAc,OAAO,KAAK;AAG1B,6BAAqB,OAAO,iBAAiB;AAG7C,cAAM,EAAE,QAAQ,cAAc,SAAS,IACrC,MAAM,WAAW,WAAW;AAC9B,yBAAiB;AAGjB,mBAAW,WAAW,UAAU;AAC9B,iBAAO,KAAK,OAAO;AAAA,QACrB;AAAA,MACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAWA,sBAAsB,CAAC,EAAE,OAAO,MAAM;AAEpC,YAAI,CAAC,YAAY,CAAC,gBAAgB;AAChC;AAAA,QACF;AAGA,cAAM,aAAa,iBAAiB;AAAA,UAClC;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,UACR,eAAe;AAAA,QACjB,CAAC;AAED,eAAO,YAAY,IAAI,UAAU;AAGjC,cAAM,QAAQ,SAAS,EAAE,YAAY,KAAK,CAAC;AAG3C,kBAAU,IAAI,eAAe,aAAa,eAAe;AAAA,UACvD,UAAU,CAAC,UAAU;AACnB,kBAAM,iBAAiB,MAAM,MAAM,MAAM,UAAU;AAAA,UACrD;AAAA,QACF,CAAC;AAED,gBAAQ,MAAM;AAAA,MAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQA,sBAAsB,CAAC,EAAE,SAAS,OAAO,MAAM;AAC7C,YAAI,CAAC,YAAY,oBAAoB;AACnC;AAAA,QACF;AAIA,cAAM,WAAW;AACjB,cAAM,UAAU,QAAQ;AACxB,cAAM,aACJ,YAAY,MACZ,YAAY,QACZ,YAAY,eACZ,YAAY;AACd,cAAM,OAAO,aAAa,cAAc;AACxC,cAAM,OAAO,QAAQ;AACrB,cAAM,YAAY,GAAG,QAAQ,MAAM,IAAI,IAAI,IAAI,GAAG,QAAQ;AAE1D,eAAO,KAAK,+BAA+B,SAAS,EAAE;AACtD,6BAAqB;AAAA,MACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQA,qBAAqB,YAAY;AAC/B,YAAI,SAAS;AACX,gBAAM,QAAQ,KAAK;AACnB,oBAAU;AAAA,QACZ;AAAA,MACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQA,oBAAoB,CAAC,EAAE,OAAO,MAAM;AAClC,YAAI,iBAAiB;AACnB,iBAAO;AAAA,YACL;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;AC7LO,IAAM,iBAAiB,KAAK,OAAO;","names":[]}

package/dist/loader-55LWCXHA.js

@@ -0,0 +1,12 @@
+import {
+  contentDirectoryExists,
+  findConfigFile,
+  loadConfig
+} from "./chunk-5PM6EQE5.js";
+import "./chunk-CRPZUUDU.js";
+export {
+  contentDirectoryExists,
+  findConfigFile,
+  loadConfig
+};
+//# sourceMappingURL=loader-55LWCXHA.js.map

package/dist/loader-55LWCXHA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}