@sonicjs-cms/core 2.19.0 → 3.0.0-beta.10

package/dist/services.cjs

@@ -1,156 +1,123 @@
 'use strict';
 
-var chunkWAEQXGCX_cjs = require('./chunk-WAEQXGCX.cjs');
-var chunkE4YFJBM2_cjs = require('./chunk-E4YFJBM2.cjs');
-var chunkRLMUFFUD_cjs = require('./chunk-RLMUFFUD.cjs');
+var chunk4BTBSXMR_cjs = require('./chunk-4BTBSXMR.cjs');
+require('./chunk-YA3TJ65D.cjs');
+require('./chunk-YP7GW2G5.cjs');
+var chunkR4ILO3W6_cjs = require('./chunk-R4ILO3W6.cjs');
+var chunkIHTXB7AT_cjs = require('./chunk-IHTXB7AT.cjs');
 require('./chunk-P3XDZL6Q.cjs');
+require('./chunk-MNWKYY5E.cjs');
 require('./chunk-IGJUBJBW.cjs');
 
 
 
 Object.defineProperty(exports, "CACHE_CONFIGS", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.CACHE_CONFIGS; }
+  get: function () { return chunk4BTBSXMR_cjs.CACHE_CONFIGS; }
 });
 Object.defineProperty(exports, "CATEGORY_INFO", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.CATEGORY_INFO; }
+  get: function () { return chunk4BTBSXMR_cjs.CATEGORY_INFO; }
 });
 Object.defineProperty(exports, "CacheService", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.CacheService; }
+  get: function () { return chunk4BTBSXMR_cjs.CacheService; }
 });
 Object.defineProperty(exports, "Logger", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.Logger; }
+  get: function () { return chunk4BTBSXMR_cjs.Logger; }
 });
 Object.defineProperty(exports, "SettingsService", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.SettingsService; }
-});
-Object.defineProperty(exports, "TelemetryService", {
-  enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.TelemetryService; }
+  get: function () { return chunk4BTBSXMR_cjs.SettingsService; }
 });
 Object.defineProperty(exports, "buildRouteList", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.buildRouteList; }
-});
-Object.defineProperty(exports, "createInstallationIdentity", {
-  enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.createInstallationIdentity; }
+  get: function () { return chunk4BTBSXMR_cjs.buildRouteList; }
 });
 Object.defineProperty(exports, "getAppInstance", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.getAppInstance; }
+  get: function () { return chunk4BTBSXMR_cjs.getAppInstance; }
 });
 Object.defineProperty(exports, "getCacheService", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.getCacheService; }
+  get: function () { return chunk4BTBSXMR_cjs.getCacheService; }
 });
 Object.defineProperty(exports, "getLogger", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.getLogger; }
-});
-Object.defineProperty(exports, "getTelemetryService", {
-  enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.getTelemetryService; }
+  get: function () { return chunk4BTBSXMR_cjs.getLogger; }
 });
 Object.defineProperty(exports, "initLogger", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.initLogger; }
+  get: function () { return chunk4BTBSXMR_cjs.initLogger; }
 });
-Object.defineProperty(exports, "initTelemetry", {
+Object.defineProperty(exports, "setAppInstance", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.initTelemetry; }
+  get: function () { return chunk4BTBSXMR_cjs.setAppInstance; }
 });
-Object.defineProperty(exports, "setAppInstance", {
+Object.defineProperty(exports, "CollectionRegistry", {
   enumerable: true,
-  get: function () { return chunkWAEQXGCX_cjs.setAppInstance; }
+  get: function () { return chunkR4ILO3W6_cjs.CollectionRegistry; }
 });
 Object.defineProperty(exports, "PluginBootstrapService", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.PluginBootstrapService; }
+  get: function () { return chunkR4ILO3W6_cjs.PluginBootstrapService; }
 });
 Object.defineProperty(exports, "PluginService", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.PluginService; }
-});
-Object.defineProperty(exports, "backfillFormSubmissions", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.backfillFormSubmissions; }
-});
-Object.defineProperty(exports, "cleanupRemovedCollections", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.cleanupRemovedCollections; }
+  get: function () { return chunkR4ILO3W6_cjs.PluginService; }
 });
-Object.defineProperty(exports, "createContentFromSubmission", {
+Object.defineProperty(exports, "TelemetryService", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.createContentFromSubmission; }
+  get: function () { return chunkR4ILO3W6_cjs.TelemetryService; }
 });
-Object.defineProperty(exports, "deriveCollectionSchemaFromFormio", {
+Object.defineProperty(exports, "collectionRecordToRow", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.deriveCollectionSchemaFromFormio; }
+  get: function () { return chunkR4ILO3W6_cjs.collectionRecordToRow; }
 });
-Object.defineProperty(exports, "deriveSubmissionTitle", {
+Object.defineProperty(exports, "createInstallationIdentity", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.deriveSubmissionTitle; }
+  get: function () { return chunkR4ILO3W6_cjs.createInstallationIdentity; }
 });
-Object.defineProperty(exports, "fullCollectionSync", {
+Object.defineProperty(exports, "getAvailableCollectionNames", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.fullCollectionSync; }
+  get: function () { return chunkR4ILO3W6_cjs.getAvailableCollectionNames; }
 });
-Object.defineProperty(exports, "getAvailableCollectionNames", {
+Object.defineProperty(exports, "getCollectionRegistry", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.getAvailableCollectionNames; }
+  get: function () { return chunkR4ILO3W6_cjs.getCollectionRegistry; }
 });
-Object.defineProperty(exports, "getManagedCollections", {
+Object.defineProperty(exports, "getTelemetryService", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.getManagedCollections; }
+  get: function () { return chunkR4ILO3W6_cjs.getTelemetryService; }
 });
-Object.defineProperty(exports, "isCollectionManaged", {
+Object.defineProperty(exports, "initTelemetry", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.isCollectionManaged; }
+  get: function () { return chunkR4ILO3W6_cjs.initTelemetry; }
 });
 Object.defineProperty(exports, "loadCollectionConfig", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.loadCollectionConfig; }
+  get: function () { return chunkR4ILO3W6_cjs.loadCollectionConfig; }
 });
 Object.defineProperty(exports, "loadCollectionConfigs", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.loadCollectionConfigs; }
-});
-Object.defineProperty(exports, "mapFormStatusToContentStatus", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.mapFormStatusToContentStatus; }
+  get: function () { return chunkR4ILO3W6_cjs.loadCollectionConfigs; }
 });
 Object.defineProperty(exports, "registerCollections", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.registerCollections; }
-});
-Object.defineProperty(exports, "syncAllFormCollections", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.syncAllFormCollections; }
-});
-Object.defineProperty(exports, "syncCollection", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.syncCollection; }
-});
-Object.defineProperty(exports, "syncCollections", {
-  enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.syncCollections; }
+  get: function () { return chunkR4ILO3W6_cjs.registerCollections; }
 });
-Object.defineProperty(exports, "syncFormCollection", {
+Object.defineProperty(exports, "resetCollectionRegistry", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.syncFormCollection; }
+  get: function () { return chunkR4ILO3W6_cjs.resetCollectionRegistry; }
 });
 Object.defineProperty(exports, "validateCollectionConfig", {
   enumerable: true,
-  get: function () { return chunkE4YFJBM2_cjs.validateCollectionConfig; }
+  get: function () { return chunkR4ILO3W6_cjs.validateCollectionConfig; }
 });
 Object.defineProperty(exports, "MigrationService", {
   enumerable: true,
-  get: function () { return chunkRLMUFFUD_cjs.MigrationService; }
+  get: function () { return chunkIHTXB7AT_cjs.MigrationService; }
 });
 //# sourceMappingURL=services.cjs.map
 //# sourceMappingURL=services.cjs.map

package/dist/services.d.cts

@@ -1,15 +1,79 @@
-export { C as CorePlugin, L as LogCategory, a as LogEntry, b as LogFilter, c as LogLevel, d as Logger, M as Migration, e as MigrationService, f as MigrationStatus, P as PluginBootstrapService, g as PluginService, h as backfillFormSubmissions, i as cleanupRemovedCollections, j as createContentFromSubmission, k as deriveCollectionSchemaFromFormio, l as deriveSubmissionTitle, m as fullCollectionSync, n as getAvailableCollectionNames, o as getLogger, p as getManagedCollections, q as initLogger, r as isCollectionManaged, s as loadCollectionConfig, t as loadCollectionConfigs, u as mapFormStatusToContentStatus, v as registerCollections, w as syncAllFormCollections, x as syncCollection, y as syncCollections, z as syncFormCollection, A as validateCollectionConfig } from './plugin-bootstrap-DfVerYV4.cjs';
-import { T as TelemetryConfig, b as TelemetryIdentity, a as TelemetryEvent, c as TelemetryProperties } from './telemetry-B9vIV4wh.cjs';
-import './collection-config-B4PG-AaF.cjs';
+export { C as CorePlugin, L as LogCategory, a as LogEntry, b as LogFilter, c as LogLevel, d as Logger, M as Migration, e as MigrationService, f as MigrationStatus, P as PluginBootstrapService, g as PluginService, h as getAvailableCollectionNames, i as getLogger, j as initLogger, l as loadCollectionConfig, k as loadCollectionConfigs, r as registerCollections, v as validateCollectionConfig } from './plugin-bootstrap-B8ThJU21.cjs';
+import { C as CollectionConfig } from './collection-config-JgHOpFCG.cjs';
+import { T as TelemetryConfig, b as TelemetryIdentity, a as TelemetryEvent, c as TelemetryProperties } from './telemetry-Cku1ax74.cjs';
 import '@cloudflare/workers-types';
 import 'drizzle-zod';
 import 'drizzle-orm/sqlite-core';
 
 /**
- * Simple Cache Service
+ * CollectionRegistry — in-memory registry of code-defined collections.
  *
- * Provides basic caching functionality for the core package
- * Can be extended with KV or other storage backends
+ * Replaces the DB `collections` table as the source of truth for collection
+ * metadata. Populated once at bootstrap from `loadCollectionConfigs()` (which
+ * reads code-registered collections). Code-defined IDs are stable across envs:
+ * `collection.id === collection.name`.
+ */
+
+interface CollectionRecord extends CollectionConfig {
+    /** Stable id = collection.name. Always equals `name` for code-defined collections. */
+    id: string;
+}
+declare class CollectionRegistry {
+    private byName;
+    private bySlug;
+    /**
+     * Replace the registry contents with the given configs. Idempotent —
+     * calling with the same configs twice yields the same state.
+     */
+    register(configs: CollectionConfig[]): void;
+    /** All registered collections (including inactive). */
+    list(): CollectionRecord[];
+    /** Active collections only. */
+    listActive(): CollectionRecord[];
+    getByName(name: string): CollectionRecord | undefined;
+    /** For code-defined collections, id === name. */
+    getById(id: string): CollectionRecord | undefined;
+    /** Look up by the URL slug (set in CollectionConfig.slug). Falls back to getByName if needed. */
+    getBySlug(slug: string): CollectionRecord | undefined;
+    /** Resolve a path segment to a record — tries slug first, then name. */
+    getBySlugOrName(slugOrName: string): CollectionRecord | undefined;
+    isActive(name: string): boolean;
+    size(): number;
+    /** Test helper — wipe state. */
+    clear(): void;
+}
+/**
+ * Map a registry record to the snake_case shape historically returned by
+ * `SELECT * FROM collections`. Used by API routes during the consumer
+ * migration so downstream clients see no schema drift.
+ */
+interface CollectionRowShape {
+    id: string;
+    name: string;
+    display_name: string;
+    description: string | null;
+    schema: any;
+    is_active: number;
+    managed: number;
+    source_type: string;
+    source_id: string | null;
+    created_at: number;
+    updated_at: number;
+}
+declare function collectionRecordToRow(record: CollectionRecord): CollectionRowShape;
+declare function getCollectionRegistry(): CollectionRegistry;
+/** Test helper — reset singleton between tests. */
+declare function resetCollectionRegistry(): void;
+
+/**
+ * Cache Service Adapter
+ *
+ * Thin facade over the cache plugin's `CacheService` so route code can keep its
+ * legacy `{ ttl, keyPrefix }` contract while writes land in the plugin's
+ * singleton — that's the same registry the admin dashboard at /admin/cache reads
+ * via `getAllCacheStats()`. Without this adapter the two caches would be split:
+ * routes would write to one, the dashboard would read from another, and the UI
+ * would always show zero entries.
  */
 interface CacheConfig {
     ttl: number;
@@ -17,49 +81,25 @@ interface CacheConfig {
 }
 declare class CacheService {
     private config;
-    private memoryCache;
+    private inner;
+    private keyExpiry;
     constructor(config: CacheConfig);
-    /**
-     * Generate cache key with prefix
-     */
     generateKey(type: string, identifier?: string): string;
-    /**
-     * Get value from cache
-     */
     get<T>(key: string): Promise<T | null>;
-    /**
-     * Get value from cache with source information
-     */
     getWithSource<T>(key: string): Promise<{
         hit: boolean;
         data: T | null;
         source: string;
         ttl?: number;
     }>;
-    /**
-     * Set value in cache
-     */
     set(key: string, value: any, ttl?: number): Promise<void>;
-    /**
-     * Delete specific key from cache
-     */
     delete(key: string): Promise<void>;
-    /**
-     * Invalidate cache keys matching a pattern
-     * For memory cache, we do simple string matching
-     */
     invalidate(pattern: string): Promise<void>;
-    /**
-     * Clear all cache
-     */
     clear(): Promise<void>;
-    /**
-     * Get value from cache or set it using a callback
-     */
     getOrSet<T>(key: string, callback: () => Promise<T>, ttl?: number): Promise<T>;
 }
 /**
- * Cache configurations for different data types
+ * Default cache configurations for different data types.
  */
 declare const CACHE_CONFIGS: {
     api: {
@@ -80,18 +120,11 @@ declare const CACHE_CONFIGS: {
     };
 };
 /**
- * Get cache service instance for a config
+ * Resolve a cache service for a config. Wraps the plugin's singleton so admin
+ * dashboard stats and route-side writes share the same store.
  */
 declare function getCacheService(config: CacheConfig): CacheService;
 
-interface Setting {
-    id: string;
-    category: string;
-    key: string;
-    value: string;
-    created_at: number;
-    updated_at: number;
-}
 interface GeneralSettings {
     siteName: string;
     siteDescription: string;
@@ -108,21 +141,13 @@ declare class SettingsService {
     private db;
     constructor(db: D1Database);
     /**
-     * Get a setting value by category and key
-     */
-    getSetting(category: string, key: string): Promise<any | null>;
-    /**
-     * Get all settings for a category
-     */
-    getCategorySettings(category: string): Promise<Record<string, any>>;
-    /**
-     * Set a setting value
+     * Get settings document for a category (general or security)
      */
-    setSetting(category: string, key: string, value: any): Promise<boolean>;
+    private getSettingsDocument;
     /**
-     * Set multiple settings at once
+     * Save settings document for a category (general or security)
      */
-    setMultipleSettings(category: string, settings: Record<string, any>): Promise<boolean>;
+    private saveSettingsDocument;
     /**
      * Get general settings with defaults
      */
@@ -202,6 +227,19 @@ declare class TelemetryService {
      * Track migration run
      */
     trackMigrationRun(properties?: TelemetryProperties): Promise<void>;
+    /**
+     * Track project snapshot — fired on bootstrap to capture runtime project shape.
+     * Arrays serialized as JSON strings (sanitizeProperties strips objects/arrays).
+     */
+    trackProjectSnapshot(data: {
+        installation_id: string;
+        collection_names: string[];
+        collection_counts: Record<string, number>;
+        active_plugins: string[];
+        field_type_histogram: Record<string, number>;
+        doc_total: number;
+        sonicjs_version: string;
+    }): Promise<void>;
     /**
      * Flush queued events
      */
@@ -269,4 +307,4 @@ declare function getAppInstance(): any;
 declare const CATEGORY_INFO: Record<string, CategoryInfo>;
 declare function buildRouteList(app: any): RouteMetadata[];
 
-export { CACHE_CONFIGS, CATEGORY_INFO, type CacheConfig, CacheService, type GeneralSettings, type RouteMetadata, type Setting, SettingsService, TelemetryService, buildRouteList, createInstallationIdentity, getAppInstance, getCacheService, getTelemetryService, initTelemetry, setAppInstance };
+export { CACHE_CONFIGS, CATEGORY_INFO, type CacheConfig, CacheService, type CollectionRecord, CollectionRegistry, type CollectionRowShape, type GeneralSettings, type RouteMetadata, type SecuritySettings, SettingsService, TelemetryService, buildRouteList, collectionRecordToRow, createInstallationIdentity, getAppInstance, getCacheService, getCollectionRegistry, getTelemetryService, initTelemetry, resetCollectionRegistry, setAppInstance };

package/dist/services.d.ts

@@ -1,15 +1,79 @@
-export { C as CorePlugin, L as LogCategory, a as LogEntry, b as LogFilter, c as LogLevel, d as Logger, M as Migration, e as MigrationService, f as MigrationStatus, P as PluginBootstrapService, g as PluginService, h as backfillFormSubmissions, i as cleanupRemovedCollections, j as createContentFromSubmission, k as deriveCollectionSchemaFromFormio, l as deriveSubmissionTitle, m as fullCollectionSync, n as getAvailableCollectionNames, o as getLogger, p as getManagedCollections, q as initLogger, r as isCollectionManaged, s as loadCollectionConfig, t as loadCollectionConfigs, u as mapFormStatusToContentStatus, v as registerCollections, w as syncAllFormCollections, x as syncCollection, y as syncCollections, z as syncFormCollection, A as validateCollectionConfig } from './plugin-bootstrap-P_ciLp_C.js';
-import { T as TelemetryConfig, b as TelemetryIdentity, a as TelemetryEvent, c as TelemetryProperties } from './telemetry-B9vIV4wh.js';
-import './collection-config-B4PG-AaF.js';
+export { C as CorePlugin, L as LogCategory, a as LogEntry, b as LogFilter, c as LogLevel, d as Logger, M as Migration, e as MigrationService, f as MigrationStatus, P as PluginBootstrapService, g as PluginService, h as getAvailableCollectionNames, i as getLogger, j as initLogger, l as loadCollectionConfig, k as loadCollectionConfigs, r as registerCollections, v as validateCollectionConfig } from './plugin-bootstrap-qu8hJgUt.js';
+import { C as CollectionConfig } from './collection-config-JgHOpFCG.js';
+import { T as TelemetryConfig, b as TelemetryIdentity, a as TelemetryEvent, c as TelemetryProperties } from './telemetry-Cku1ax74.js';
 import '@cloudflare/workers-types';
 import 'drizzle-zod';
 import 'drizzle-orm/sqlite-core';
 
 /**
- * Simple Cache Service
+ * CollectionRegistry — in-memory registry of code-defined collections.
  *
- * Provides basic caching functionality for the core package
- * Can be extended with KV or other storage backends
+ * Replaces the DB `collections` table as the source of truth for collection
+ * metadata. Populated once at bootstrap from `loadCollectionConfigs()` (which
+ * reads code-registered collections). Code-defined IDs are stable across envs:
+ * `collection.id === collection.name`.
+ */
+
+interface CollectionRecord extends CollectionConfig {
+    /** Stable id = collection.name. Always equals `name` for code-defined collections. */
+    id: string;
+}
+declare class CollectionRegistry {
+    private byName;
+    private bySlug;
+    /**
+     * Replace the registry contents with the given configs. Idempotent —
+     * calling with the same configs twice yields the same state.
+     */
+    register(configs: CollectionConfig[]): void;
+    /** All registered collections (including inactive). */
+    list(): CollectionRecord[];
+    /** Active collections only. */
+    listActive(): CollectionRecord[];
+    getByName(name: string): CollectionRecord | undefined;
+    /** For code-defined collections, id === name. */
+    getById(id: string): CollectionRecord | undefined;
+    /** Look up by the URL slug (set in CollectionConfig.slug). Falls back to getByName if needed. */
+    getBySlug(slug: string): CollectionRecord | undefined;
+    /** Resolve a path segment to a record — tries slug first, then name. */
+    getBySlugOrName(slugOrName: string): CollectionRecord | undefined;
+    isActive(name: string): boolean;
+    size(): number;
+    /** Test helper — wipe state. */
+    clear(): void;
+}
+/**
+ * Map a registry record to the snake_case shape historically returned by
+ * `SELECT * FROM collections`. Used by API routes during the consumer
+ * migration so downstream clients see no schema drift.
+ */
+interface CollectionRowShape {
+    id: string;
+    name: string;
+    display_name: string;
+    description: string | null;
+    schema: any;
+    is_active: number;
+    managed: number;
+    source_type: string;
+    source_id: string | null;
+    created_at: number;
+    updated_at: number;
+}
+declare function collectionRecordToRow(record: CollectionRecord): CollectionRowShape;
+declare function getCollectionRegistry(): CollectionRegistry;
+/** Test helper — reset singleton between tests. */
+declare function resetCollectionRegistry(): void;
+
+/**
+ * Cache Service Adapter
+ *
+ * Thin facade over the cache plugin's `CacheService` so route code can keep its
+ * legacy `{ ttl, keyPrefix }` contract while writes land in the plugin's
+ * singleton — that's the same registry the admin dashboard at /admin/cache reads
+ * via `getAllCacheStats()`. Without this adapter the two caches would be split:
+ * routes would write to one, the dashboard would read from another, and the UI
+ * would always show zero entries.
  */
 interface CacheConfig {
     ttl: number;
@@ -17,49 +81,25 @@ interface CacheConfig {
 }
 declare class CacheService {
     private config;
-    private memoryCache;
+    private inner;
+    private keyExpiry;
     constructor(config: CacheConfig);
-    /**
-     * Generate cache key with prefix
-     */
     generateKey(type: string, identifier?: string): string;
-    /**
-     * Get value from cache
-     */
     get<T>(key: string): Promise<T | null>;
-    /**
-     * Get value from cache with source information
-     */
     getWithSource<T>(key: string): Promise<{
         hit: boolean;
         data: T | null;
         source: string;
         ttl?: number;
     }>;
-    /**
-     * Set value in cache
-     */
     set(key: string, value: any, ttl?: number): Promise<void>;
-    /**
-     * Delete specific key from cache
-     */
     delete(key: string): Promise<void>;
-    /**
-     * Invalidate cache keys matching a pattern
-     * For memory cache, we do simple string matching
-     */
     invalidate(pattern: string): Promise<void>;
-    /**
-     * Clear all cache
-     */
     clear(): Promise<void>;
-    /**
-     * Get value from cache or set it using a callback
-     */
     getOrSet<T>(key: string, callback: () => Promise<T>, ttl?: number): Promise<T>;
 }
 /**
- * Cache configurations for different data types
+ * Default cache configurations for different data types.
  */
 declare const CACHE_CONFIGS: {
     api: {
@@ -80,18 +120,11 @@ declare const CACHE_CONFIGS: {
     };
 };
 /**
- * Get cache service instance for a config
+ * Resolve a cache service for a config. Wraps the plugin's singleton so admin
+ * dashboard stats and route-side writes share the same store.
  */
 declare function getCacheService(config: CacheConfig): CacheService;
 
-interface Setting {
-    id: string;
-    category: string;
-    key: string;
-    value: string;
-    created_at: number;
-    updated_at: number;
-}
 interface GeneralSettings {
     siteName: string;
     siteDescription: string;
@@ -108,21 +141,13 @@ declare class SettingsService {
     private db;
     constructor(db: D1Database);
     /**
-     * Get a setting value by category and key
-     */
-    getSetting(category: string, key: string): Promise<any | null>;
-    /**
-     * Get all settings for a category
-     */
-    getCategorySettings(category: string): Promise<Record<string, any>>;
-    /**
-     * Set a setting value
+     * Get settings document for a category (general or security)
      */
-    setSetting(category: string, key: string, value: any): Promise<boolean>;
+    private getSettingsDocument;
     /**
-     * Set multiple settings at once
+     * Save settings document for a category (general or security)
      */
-    setMultipleSettings(category: string, settings: Record<string, any>): Promise<boolean>;
+    private saveSettingsDocument;
     /**
      * Get general settings with defaults
      */
@@ -202,6 +227,19 @@ declare class TelemetryService {
      * Track migration run
      */
     trackMigrationRun(properties?: TelemetryProperties): Promise<void>;
+    /**
+     * Track project snapshot — fired on bootstrap to capture runtime project shape.
+     * Arrays serialized as JSON strings (sanitizeProperties strips objects/arrays).
+     */
+    trackProjectSnapshot(data: {
+        installation_id: string;
+        collection_names: string[];
+        collection_counts: Record<string, number>;
+        active_plugins: string[];
+        field_type_histogram: Record<string, number>;
+        doc_total: number;
+        sonicjs_version: string;
+    }): Promise<void>;
     /**
      * Flush queued events
      */
@@ -269,4 +307,4 @@ declare function getAppInstance(): any;
 declare const CATEGORY_INFO: Record<string, CategoryInfo>;
 declare function buildRouteList(app: any): RouteMetadata[];
 
-export { CACHE_CONFIGS, CATEGORY_INFO, type CacheConfig, CacheService, type GeneralSettings, type RouteMetadata, type Setting, SettingsService, TelemetryService, buildRouteList, createInstallationIdentity, getAppInstance, getCacheService, getTelemetryService, initTelemetry, setAppInstance };
+export { CACHE_CONFIGS, CATEGORY_INFO, type CacheConfig, CacheService, type CollectionRecord, CollectionRegistry, type CollectionRowShape, type GeneralSettings, type RouteMetadata, type SecuritySettings, SettingsService, TelemetryService, buildRouteList, collectionRecordToRow, createInstallationIdentity, getAppInstance, getCacheService, getCollectionRegistry, getTelemetryService, initTelemetry, resetCollectionRegistry, setAppInstance };

package/dist/services.js

@@ -1,7 +1,10 @@
-export { CACHE_CONFIGS, CATEGORY_INFO, CacheService, Logger, SettingsService, TelemetryService, buildRouteList, createInstallationIdentity, getAppInstance, getCacheService, getLogger, getTelemetryService, initLogger, initTelemetry, setAppInstance } from './chunk-QFWHAFEO.js';
-export { PluginBootstrapService, PluginService, backfillFormSubmissions, cleanupRemovedCollections, createContentFromSubmission, deriveCollectionSchemaFromFormio, deriveSubmissionTitle, fullCollectionSync, getAvailableCollectionNames, getManagedCollections, isCollectionManaged, loadCollectionConfig, loadCollectionConfigs, mapFormStatusToContentStatus, registerCollections, syncAllFormCollections, syncCollection, syncCollections, syncFormCollection, validateCollectionConfig } from './chunk-JZV22DEV.js';
-export { MigrationService } from './chunk-ZYAYUIZE.js';
+export { CACHE_CONFIGS, CATEGORY_INFO, CacheService, Logger, SettingsService, buildRouteList, getAppInstance, getCacheService, getLogger, initLogger, setAppInstance } from './chunk-RQ6N3FTV.js';
+import './chunk-K25XHMM3.js';
+import './chunk-AI663NBO.js';
+export { CollectionRegistry, PluginBootstrapService, PluginService, TelemetryService, collectionRecordToRow, createInstallationIdentity, getAvailableCollectionNames, getCollectionRegistry, getTelemetryService, initTelemetry, loadCollectionConfig, loadCollectionConfigs, registerCollections, resetCollectionRegistry, validateCollectionConfig } from './chunk-PYVFXCSD.js';
+export { MigrationService } from './chunk-ALDRXTUO.js';
 import './chunk-X7ZAEI5S.js';
+import './chunk-TQABQWOP.js';
 import './chunk-V4OQ3NZ2.js';
 //# sourceMappingURL=services.js.map
 //# sourceMappingURL=services.js.map

package/dist/{telemetry-B9vIV4wh.d.cts → telemetry-Cku1ax74.d.cts}

@@ -4,7 +4,7 @@
  * Privacy-first telemetry types for SonicJS
  * No PII (Personally Identifiable Information) is collected
  */
-type TelemetryEvent = 'installation_started' | 'installation_completed' | 'installation_failed' | 'setup_wizard_started' | 'setup_wizard_completed' | 'first_dev_server_start' | 'dev_server_started' | 'dev_server_stopped' | 'admin_login' | 'plugin_activated' | 'plugin_deactivated' | 'collection_created' | 'content_created' | 'page_viewed' | 'feature_used' | 'error_occurred' | 'migration_run' | 'deployment_triggered';
+type TelemetryEvent = 'installation_started' | 'installation_completed' | 'installation_failed' | 'setup_wizard_started' | 'setup_wizard_completed' | 'first_dev_server_start' | 'dev_server_started' | 'dev_server_stopped' | 'admin_login' | 'plugin_activated' | 'plugin_deactivated' | 'collection_created' | 'content_created' | 'page_viewed' | 'feature_used' | 'error_occurred' | 'migration_run' | 'deployment_triggered' | 'project_snapshot';
 interface TelemetryProperties {
     os?: 'darwin' | 'linux' | 'win32' | string;
     nodeVersion?: string;

package/dist/{telemetry-B9vIV4wh.d.ts → telemetry-Cku1ax74.d.ts}

@@ -4,7 +4,7 @@
  * Privacy-first telemetry types for SonicJS
  * No PII (Personally Identifiable Information) is collected
  */
-type TelemetryEvent = 'installation_started' | 'installation_completed' | 'installation_failed' | 'setup_wizard_started' | 'setup_wizard_completed' | 'first_dev_server_start' | 'dev_server_started' | 'dev_server_stopped' | 'admin_login' | 'plugin_activated' | 'plugin_deactivated' | 'collection_created' | 'content_created' | 'page_viewed' | 'feature_used' | 'error_occurred' | 'migration_run' | 'deployment_triggered';
+type TelemetryEvent = 'installation_started' | 'installation_completed' | 'installation_failed' | 'setup_wizard_started' | 'setup_wizard_completed' | 'first_dev_server_start' | 'dev_server_started' | 'dev_server_stopped' | 'admin_login' | 'plugin_activated' | 'plugin_deactivated' | 'collection_created' | 'content_created' | 'page_viewed' | 'feature_used' | 'error_occurred' | 'migration_run' | 'deployment_triggered' | 'project_snapshot';
 interface TelemetryProperties {
     os?: 'darwin' | 'linux' | 'win32' | string;
     nodeVersion?: string;