@easy-cms/core 0.60.0 → 0.61.0

package/dist/{chunk-CGVNZUW4.js → chunk-FPFWLQB5.js}

@@ -369,6 +369,23 @@ function defineConfig(config) {
   return config;
 }
 
+// src/deprecation.ts
+var KEY = /* @__PURE__ */ Symbol.for("easy-cms.deprecations");
+function warned() {
+  const store = globalThis;
+  store[KEY] ??= /* @__PURE__ */ new Set();
+  return store[KEY];
+}
+function warnDeprecated(code, message) {
+  const seen = warned();
+  if (seen.has(code)) return;
+  seen.add(code);
+  const node = globalThis.process;
+  if (typeof node?.emitWarning === "function")
+    node.emitWarning(message, { type: "DeprecationWarning", code });
+  else console.warn(`[${code}] DeprecationWarning: ${message}`);
+}
+
 // src/field-types.ts
 var FIELD_TYPE_BASES = [
   "text",
@@ -527,6 +544,7 @@ export {
   PLUGIN_API_VERSION,
   definePlugin,
   defineConfig,
+  warnDeprecated,
   FIELD_TYPE_BASES,
   defineFieldType,
   fieldTypeModules,

package/dist/{chunk-S2AJVHR4.js → chunk-HTE5O3EG.js}

@@ -32,8 +32,9 @@ import {
   storageKey,
   typeFromName,
   uniqueWithinOf,
+  warnDeprecated,
   withPrivacy
-} from "./chunk-CGVNZUW4.js";
+} from "./chunk-FPFWLQB5.js";
 
 // src/access.ts
 var isSystemAdmin = (user) => user?.role === "admin" && !user.apiKey && user.scoped !== true;
@@ -8788,7 +8789,7 @@ async function readAdminModule(cms, index) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.60.0" : "0.0.0-dev";
+var VERSION = true ? "0.61.0" : "0.0.0-dev";
 
 // src/rest/admin-deliveries.ts
 var PER_PAGE = 50;
@@ -9895,6 +9896,11 @@ async function route(cms, ctx, method, path, options) {
   if (first === "admin" && ctx.user?.member === true) throw new ForbiddenError();
   const authAction = third === void 0 && second !== void 0 ? first === "auth" && AUTH_ACTIONS.has(second) || first === USERS && !/^\d+$/.test(second) : false;
   if (first === "auth" && !authAction) return ssoRoute(cms, ctx, method, segments);
+  if (authAction && first === USERS && second !== void 0 && AUTH_ACTIONS.has(second))
+    warnDeprecated(
+      "EASY_CMS_DEP001",
+      `${method} <api>/users/${second} is now <api>/auth/${second}; the old path works through 1.x.`
+    );
   if (authAction && second !== void 0) {
     switch (`${method} ${second}`) {
       case "POST login": {
@@ -10303,6 +10309,8 @@ async function route(cms, ctx, method, path, options) {
       return { body: await cms.findGlobal(second, { ...access, ...parseDepth(ctx.url), draft }) };
     }
     if (method === "PATCH" || method === "POST") {
+      if (method === "POST")
+        warnDeprecated("EASY_CMS_DEP002", "Globals are updated with PATCH; POST works through 1.x.");
       const body = await readJson(ctx.request);
       return { body: await cms.updateGlobal(second, body, { ...access, ...parseDepth(ctx.url) }) };
     }
@@ -10550,7 +10558,13 @@ function scheduleJob(body) {
 }
 function parseLocale(url) {
   const locale = url.searchParams.get("locale");
-  const fallback = url.searchParams.get("fallbackLocale") ?? url.searchParams.get("fallback-locale");
+  const old = url.searchParams.get("fallback-locale");
+  if (old !== null)
+    warnDeprecated(
+      "EASY_CMS_DEP003",
+      "?fallback-locale= is now ?fallbackLocale=; the old name works through 1.x."
+    );
+  const fallback = url.searchParams.get("fallbackLocale") ?? old;
   return {
     ...locale ? { locale } : {},
     ...fallback === "false" || fallback === "true" ? { fallbackLocale: fallback === "true" } : {}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { P as PaginatedDocs, I as ID, E as EmailSetting } from './config-jzFGsNL6.js';
 export { A as ADAPTER_API_VERSION, a as ADMIN_ICONS, b as Access, c as AccessArgs, d as AccessOptions, e as AdminBrand, f as AdminCommand, g as AdminComponent, h as AdminConfig, i as AdminFieldArgs, j as AdminIcon, k as AdminLocale, l as AdminPage, m as AdminRole, n as AdminRoleChange, o as AdminRoleField, p as AdminRoleTarget, q as AdminRoleView, r as AdminRoles, s as AdminSso, t as AdminSwitcher, u as AdminViewAccess, v as AfterChangeHook, w as AfterDeleteHook, x as AfterReadHook, y as ApiKeyContext, z as ApiKeyGlobalOperation, B as ApiKeyOperation, C as ApiKeyPermissions, D as ArrayField, F as AuditChange, G as AuditConfig, H as AuditEntry, J as AuditLog, K as AuditPage, L as AuditVerification, M as Auth, N as AuthConfig, O as AuthProvider, Q as AuthProviderProfile, R as AuthProviderRequest, S as AuthUser, T as BackupsConfig, U as BeforeChangeHook, V as BeforeDeleteHook, W as BeforeValidateHook, X as Block, Y as BlocksField, Z as BooleanField, _ as BuiltinApiKeysCollection, $ as BuiltinMediaCollection, a0 as BuiltinMediaFoldersCollection, a1 as BuiltinUsersCollection, a2 as BundleHints, a3 as CliCommand, a4 as CollectionAccess, a5 as CollectionAdmin, a6 as CollectionConfig, a7 as CollectionDocument, a8 as CollectionHooks, a9 as CollectionListAdmin, aa as CollectionSlug, ab as Config, ac as ConfigError, ad as ConfigIssue, ae as ContainerAdmin, af as CreateEasyCMSOptions, ag as CreateInput, ah as CreateMigrationResult, ai as CustomField, aj as CustomFieldTypes, ak as DashboardWidget, al as Database, am as DatabaseAdapter, an as DatabaseInitArgs, ao as DatabaseTransfer, ap as DateField, aq as DepthOptions, ar as DirectUpload, as as DiskStorageOptions, at as DocumentOf, au as EasyCMS, av as EasyCMSError, aw as EmailAdapter, ax as EmailField, ay as EmailMessage, az as Endpoint, aA as EndpointRequest, aB as ErrorCode, aC as FIELD_TYPES, aD as Field, aE as FieldAccess, aF as FieldAccessFn, aG as FieldAdmin, aH as FieldError, aI as FieldRule, aJ as FieldType, aK as FieldTypeBase, aL as FieldTypeDefinition, aM as FieldTypeValidateContext, aN as FieldValidate, aO as FieldValidateContext, aP as FieldValue, aQ as FieldsInput, aR as FieldsValue, aS as FilterOptions, aT as FilterOptionsArgs, aU as FindArgs, aV as FindOptions, aW as FolderLevel, aX as FolderPermissions, aY as ForbiddenError, aZ as GlobalAccess, a_ as GlobalConfig, a$ as GlobalDocument, b0 as GlobalHooks, b1 as GlobalInput, b2 as GlobalSlug, b3 as GroupField, b4 as ImageSize, b5 as IncrementOptions, b6 as InferCollection, b7 as InferGlobal, b8 as JobConfig, b9 as JsonField, ba as Label, bb as LayoutNode, bc as LivePreview, bd as LocalizationConfig, be as Logger, bf as LoginArgs, bg as MediaDocument, bh as MediaSize, bi as MembersConfig, bj as MembersSignup, bk as MigrationInfo, bl as NavGroup, bm as NotFoundError, bn as NumberField, bo as OnRequest, bp as OnRequestArgs, bq as Operation, br as PLUGIN_API_VERSION, bs as PasswordEmail, bt as PasswordEmailArgs, bu as PasswordEmailFn, bv as PasswordLinkOptions, bw as PayloadTooLargeError, bx as Plugin, by as PluginInfo, bz as PluginTypes, bA as PreviewTarget, bB as PreviewURL, bC as QueryError, bD as ROLE_OPERATIONS, bE as RawDocument, bF as ReadOptions, bG as RelationshipField, bH as RequestContext, bI as ResolvedConfig, bJ as RichTextDocument, bK as RichTextField, bL as Role, bM as RoleOperation, bN as RolePermissions, bO as Roles, bP as RoutesConfig, bQ as ScheduledPublish, bR as SchemaError, bS as SchemaMode, bT as SelectField, bU as SelectOption, bV as Session, bW as SidebarPanel, bX as SignupArgs, bY as SignupResult, bZ as SingleSignOn, b_ as SlugField, b$ as SlugOf, c0 as SsoOutcome, c1 as SsoProviderRef, c2 as StorageAdapter, c3 as StoredFile, c4 as TextField, c5 as TextareaField, c6 as TooManyRequestsError, c7 as TypedPlugin, c8 as UnauthorizedError, c9 as UpdateInput, ca as UpdateOptions, cb as UploadConfig, cc as UploadField, cd as UploadFromURLConfig, ce as UserIdentity, cf as ValidationError, cg as Version, ch as VersionSummary, ci as VersionsConfig, cj as WEBHOOK_EVENTS, ck as WebhookConfig, cl as WebhookEvent, cm as WebhookPayload, cn as Where, co as WhereOperators, cp as anyone, cq as consoleEmail, cr as consoleLogger, cs as createEasyCMS, ct as defineConfig, cu as defineFieldType, cv as definePlugin, cw as diskStorage, cx as hasRows, cy as isAdmin, cz as isHasMany, cA as isSignedIn, cB as isStaff, cC as isSystemAdmin, cD as mimeAllowedBy, cE as rowFields, cF as silentLogger, cG as uniqueWithinOf } from './config-jzFGsNL6.js';
-export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail } from './plugin-EX9OHwR3.js';
+export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail, w as warnDeprecated } from './plugin-C19Bt8ux.js';
 export { A as AdminBackup, a as AdminBackups, b as ApiHandlerOptions, B as BackupState, L as LoadConfigOptions, R as RestHandler, c as RestHandlerOptions, d as createApiHandler, e as createRestHandler, l as loadConfig, r as resolveConfig, s as sharedEasyCMS, f as slugify } from './handler-CMA1LIq7.js';
 export { FieldCondition, matchesCondition } from './conditions.js';
 

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   sharedEasyCMS,
   silentLogger,
   slugify
-} from "./chunk-S2AJVHR4.js";
+} from "./chunk-HTE5O3EG.js";
 import {
   matchesCondition
 } from "./chunk-U266LV4M.js";
@@ -46,8 +46,9 @@ import {
   ValidationError,
   defineConfig,
   defineFieldType,
-  definePlugin
-} from "./chunk-CGVNZUW4.js";
+  definePlugin,
+  warnDeprecated
+} from "./chunk-FPFWLQB5.js";
 export {
   ADAPTER_API_VERSION,
   ADMIN_API_VERSION,
@@ -90,5 +91,6 @@ export {
   resolveConfig,
   sharedEasyCMS,
   silentLogger,
-  slugify
+  slugify,
+  warnDeprecated
 };

package/dist/internal.js

@@ -52,7 +52,7 @@ import {
   verifyPassword,
   verifyTurnstile,
   writeBackupFile
-} from "./chunk-S2AJVHR4.js";
+} from "./chunk-HTE5O3EG.js";
 import {
   conditionIssues
 } from "./chunk-U266LV4M.js";
@@ -70,7 +70,7 @@ import {
   rowFields,
   sniffMimeType,
   uniqueWithinOf
-} from "./chunk-CGVNZUW4.js";
+} from "./chunk-FPFWLQB5.js";
 
 // src/typegen.ts
 var pascal = (name) => name.split(/[^A-Za-z0-9]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");

package/dist/{plugin-EX9OHwR3.d.ts → plugin-C19Bt8ux.d.ts}

@@ -323,4 +323,18 @@ interface SetFieldDetail {
     readonly value: unknown;
 }
 
-export { ADMIN_API_VERSION as A, type SetFieldDetail as S, type AdminCollection as a, type AdminComponentRef as b, type AdminElementProps as c, type AdminField as d, type AdminGlobal as e, type AdminLayoutNode as f, type AdminNavGroup as g, type AdminNavItem as h, type AdminNavNode as i, type AdminPageRef as j, type AdminPageRoute as k, type AdminSchema as l, type AdminWidgetRef as m };
+/**
+ * Logs that something deprecated was used, once per `code` and process. On Node.js it is a
+ * `DeprecationWarning` (`process.emitWarning`), so `--no-deprecation` hides it,
+ * `--throw-deprecation` turns it into an error and `--trace-deprecation` shows where it came
+ * from; elsewhere `console.warn`.
+ *
+ * Plugins use codes of their own, e.g. `ACME_SEO_DEP001`.
+ *
+ * ```ts
+ * warnDeprecated('ACME_DEP001', '`acmePlugin({ key })` is now `apiKey`; `key` goes in 2.0.')
+ * ```
+ */
+declare function warnDeprecated(code: string, message: string): void;
+
+export { ADMIN_API_VERSION as A, type SetFieldDetail as S, type AdminCollection as a, type AdminComponentRef as b, type AdminElementProps as c, type AdminField as d, type AdminGlobal as e, type AdminLayoutNode as f, type AdminNavGroup as g, type AdminNavItem as h, type AdminNavNode as i, type AdminPageRef as j, type AdminPageRoute as k, type AdminSchema as l, type AdminWidgetRef as m, warnDeprecated as w };

package/dist/plugin.d.ts

@@ -1,3 +1,3 @@
 export { a as ADMIN_ICONS, g as AdminComponent, j as AdminIcon, S as AuthUser, a3 as CliCommand, a4 as CollectionAccess, a6 as CollectionConfig, ab as Config, ac as ConfigError, ak as DashboardWidget, av as EasyCMSError, az as Endpoint, aA as EndpointRequest, aB as ErrorCode, aD as Field, aE as FieldAccess, aH as FieldError, aK as FieldTypeBase, aL as FieldTypeDefinition, aM as FieldTypeValidateContext, aY as ForbiddenError, a_ as GlobalConfig, I as ID, b8 as JobConfig, ba as Label, bl as NavGroup, bm as NotFoundError, bo as OnRequest, bp as OnRequestArgs, br as PLUGIN_API_VERSION, bw as PayloadTooLargeError, bx as Plugin, by as PluginInfo, bz as PluginTypes, bC as QueryError, bH as RequestContext, c6 as TooManyRequestsError, c7 as TypedPlugin, c8 as UnauthorizedError, cf as ValidationError, cn as Where, cu as defineFieldType, cv as definePlugin } from './config-jzFGsNL6.js';
-export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail } from './plugin-EX9OHwR3.js';
+export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-C19Bt8ux.js';
 import './conditions.js';

package/dist/plugin.js

@@ -14,8 +14,9 @@ import {
   UnauthorizedError,
   ValidationError,
   defineFieldType,
-  definePlugin
-} from "./chunk-CGVNZUW4.js";
+  definePlugin,
+  warnDeprecated
+} from "./chunk-FPFWLQB5.js";
 export {
   ADMIN_API_VERSION,
   ADMIN_ICONS,
@@ -30,5 +31,6 @@ export {
   UnauthorizedError,
   ValidationError,
   defineFieldType,
-  definePlugin
+  definePlugin,
+  warnDeprecated
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easy-cms/core",
-  "version": "0.60.0",
+  "version": "0.61.0",
   "description": "Embedded, code-first headless CMS for Nuxt and Next.js",
   "license": "MIT",
   "type": "module",