canopycms 0.0.15 → 0.0.17

package/dist/utils/title-field.js

@@ -0,0 +1,126 @@
+/**
+ * Find the field marked `isTitle: true` in a schema and extract its value from data.
+ * Recurses into object fields to support nested title fields (e.g., hero.title).
+ * Returns the string value or undefined if not found or not a string.
+ */
+export function extractTitleFromSchema(fields, data) {
+    return findTitleValue(fields, data);
+}
+function findTitleValue(fields, data) {
+    for (const field of fields) {
+        if (field.isTitle) {
+            const value = data[field.name];
+            return typeof value === 'string' ? value : undefined;
+        }
+        // Recurse into non-list object fields (list objects can't provide a single title value)
+        if (field.type === 'object' && 'fields' in field && field.fields && !field.list) {
+            const nested = data[field.name];
+            if (nested != null && typeof nested === 'object' && !Array.isArray(nested)) {
+                const result = findTitleValue(field.fields, nested);
+                if (result !== undefined)
+                    return result;
+            }
+        }
+    }
+    return undefined;
+}
+/** Convert a slug like "my-cool-page" to "My Cool Page". */
+export function humanizeSlug(slug) {
+    return slug
+        .replace(/[-_]/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .trim();
+}
+/**
+ * Resolve a display title for an entry using the full fallback chain:
+ * 1. Schema-marked isTitle field (if schema provided)
+ * 2. Convention: data.title or data.name
+ * 3. Entry type label (if provided)
+ * 4. Humanized slug (if provided)
+ * 5. "Untitled"
+ */
+export function resolveEntryTitle(data, options) {
+    // 1. Schema-marked isTitle field
+    if (options?.schema) {
+        const schemaTitle = extractTitleFromSchema(options.schema, data);
+        if (schemaTitle)
+            return schemaTitle;
+    }
+    // 2. Convention: data.title or data.name
+    const title = data.title ?? data.name;
+    if (typeof title === 'string')
+        return title;
+    // 3. Entry type label
+    if (options?.entryTypeLabel)
+        return options.entryTypeLabel;
+    // 4. Humanized slug
+    return options?.slug ? humanizeSlug(options.slug) : 'Untitled';
+}
+/**
+ * Count the number of fields marked `isTitle: true` in a schema, recursing into objects.
+ * Skips `list: true` objects since runtime title extraction cannot resolve array values.
+ * Used for validation — at most one field per schema should be marked.
+ */
+export function countTitleFields(fields) {
+    let count = 0;
+    for (const field of fields) {
+        if (field.isTitle)
+            count++;
+        if (field.type === 'object' && 'fields' in field && field.fields && !field.list) {
+            count += countTitleFields(field.fields);
+        }
+    }
+    return count;
+}
+/**
+ * Validate that all isTitle fields in a schema are string type.
+ * Skips `list: true` objects (those are caught by findTitleFieldsInLists).
+ * Returns an array of field names that have isTitle on a non-string type.
+ */
+export function findInvalidTitleFields(fields, parentPath) {
+    const invalid = [];
+    for (const field of fields) {
+        const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name;
+        if (field.isTitle && field.type !== 'string') {
+            invalid.push(fieldPath);
+        }
+        if (field.type === 'object' && 'fields' in field && field.fields && !field.list) {
+            invalid.push(...findInvalidTitleFields(field.fields, fieldPath));
+        }
+    }
+    return invalid;
+}
+/**
+ * Find isTitle fields inside `list: true` object fields, where they can never resolve.
+ * Returns dotted paths of such fields.
+ */
+export function findTitleFieldsInLists(fields, parentPath) {
+    const found = [];
+    for (const field of fields) {
+        const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name;
+        if (field.type === 'object' && 'fields' in field && field.fields) {
+            if (field.list) {
+                // Any isTitle inside a list object is invalid — collect them
+                found.push(...collectAllTitleFields(field.fields, fieldPath));
+            }
+            else {
+                found.push(...findTitleFieldsInLists(field.fields, fieldPath));
+            }
+        }
+    }
+    return found;
+}
+/** Collect all isTitle fields recursively (used inside list context). */
+function collectAllTitleFields(fields, parentPath) {
+    const found = [];
+    for (const field of fields) {
+        const fieldPath = `${parentPath}.${field.name}`;
+        if (field.isTitle)
+            found.push(fieldPath);
+        if (field.type === 'object' && 'fields' in field && field.fields) {
+            found.push(...collectAllTitleFields(field.fields, fieldPath));
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=title-field.js.map

package/dist/utils/title-field.js.map

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

package/dist/validation/reference-validator.js

@@ -1,5 +1,5 @@
-import { isValidId } from '../id';
-import { findFieldsByType } from './field-traversal';
+import { isValidId } from '../id.js';
+import { findFieldsByType } from './field-traversal.js';
 /**
  * ReferenceValidator validates that referenced content IDs exist and match collection constraints.
  *

package/dist/worker/cms-worker.js

@@ -2,11 +2,11 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { simpleGit } from 'simple-git';
 import { Octokit } from '@octokit/rest';
-import { dequeueTask, completeTask, failTask, retryTask, recoverOrphanedTasks, cleanupOldTasks, cmsTaskQueueLogger, } from './task-queue';
-import { getBranchMetadataFileManager, BranchMetadataFileManager } from '../branch-metadata';
-import { extractIdFromFilename } from '../content-id-index';
-import { ROOT_COLLECTION_ID } from '../paths/types';
-import { isFileExistsError } from '../utils/error';
+import { dequeueTask, completeTask, failTask, retryTask, recoverOrphanedTasks, cleanupOldTasks, cmsTaskQueueLogger, } from './task-queue.js';
+import { getBranchMetadataFileManager, BranchMetadataFileManager } from '../branch-metadata.js';
+import { extractIdFromFilename } from '../content-id-index.js';
+import { ROOT_COLLECTION_ID } from '../paths/types.js';
+import { isFileExistsError } from '../utils/error.js';
 const DEFAULT_TASK_TIMEOUT = 60_000;
 const DEFAULT_MAX_RETRIES = 3;
 // Payload validation helpers — fail fast with clear errors instead of silent `as` casts

package/dist/worker/task-queue-config.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { DEFAULT_PROD_WORKSPACE } from '../config';
+import { DEFAULT_PROD_WORKSPACE } from '../config/index.js';
 /**
  * Get the task queue directory for async worker operations.
  *

package/dist/worker/task-queue.js

@@ -2,7 +2,7 @@
  * CanopyCMS task queue — re-exports from the generic task-queue module
  * with CMS-specific action types and a WorkerTask alias.
  */
-import { createDebugLogger } from '../utils/debug';
+import { createDebugLogger } from '../utils/debug.js';
 // ============================================================================
 // Shared logger instance for CMS task queue operations
 // ============================================================================
@@ -16,5 +16,5 @@ export const cmsTaskQueueLogger = {
 // Re-exports from generic task-queue module
 // ============================================================================
 export { enqueueTask, dequeueTask, completeTask, failTask, retryTask, recoverOrphanedTasks, cleanupOldTasks, getTask, getTask as getTaskResult, // backward-compatible alias
-listTasks, getQueueStats, } from '../task-queue';
+listTasks, getQueueStats, } from '../task-queue/index.js';
 //# sourceMappingURL=task-queue.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "@codemirror/language, @lezer/highlight: workaround — @mdxeditor/editor uses cm6-theme-basic-light which peer-requires these but mdxeditor doesn't declare them as dependencies",
   "name": "canopycms",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "CanopyCMS core package: schema-driven content, branch-aware editing, and editor UI for Next.js.",
   "license": "MIT",
   "repository": {