@strapi/utils 5.49.0 → 5.50.1

package/dist/traverse-entity.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-entity.mjs","sources":["../src/traverse-entity.ts"],"sourcesContent":["import { clone, isObject, isArray, isNil, curry } from 'lodash/fp';\n\nimport type { Attribute, AnyAttribute, Model, Data } from './types';\nimport { isRelationalAttribute, isMediaAttribute } from './content-types';\n\n/**\n * Execute promises in parallel but throw errors in array index order.\n */\nconst parallelWithOrderedErrors = async <T>(promises: Promise<T>[]): Promise<T[]> => {\n  const results = await Promise.allSettled(promises);\n\n  // Throw first error in array index order (matches sequential behavior)\n  for (let i = 0; i < results.length; i += 1) {\n    const result = results[i];\n    if (result.status === 'rejected') {\n      throw result.reason;\n    }\n  }\n\n  return results.map((r) => (r as PromiseFulfilledResult<T>).value);\n};\n\nexport type VisitorUtils = ReturnType<typeof createVisitorUtils>;\n\nexport interface VisitorOptions {\n  data: Record<string, unknown>;\n  schema: Model;\n  key: string;\n  value: Data[keyof Data];\n  attribute?: AnyAttribute;\n  path: Path;\n  getModel(uid: string): Model;\n  parent?: Parent;\n  /** Extra root-level keys allowed (e.g. registered input params). Only used when path.attribute === null. */\n  allowedExtraRootKeys?: string[];\n}\n\nexport type Visitor = (visitorOptions: VisitorOptions, visitorUtils: VisitorUtils) => void;\n\nexport interface Path {\n  raw: string | null;\n  attribute: string | null;\n  rawWithIndices?: string | null;\n}\n\nexport interface TraverseOptions {\n  schema: Model;\n  path?: Path;\n  parent?: Parent;\n  getModel(uid: string): Model;\n  /** Extra root-level keys allowed (e.g. registered input params). Only used when path.attribute === null. */\n  allowedExtraRootKeys?: string[];\n}\n\nexport interface Parent {\n  attribute?: Attribute;\n  key: string | null;\n  path: Path;\n  schema: Model;\n}\n\nconst traverseEntity = async (\n  visitor: Visitor,\n  options: TraverseOptions,\n  entity: Data\n): Promise<Data> => {\n  const {\n    path = { raw: null, attribute: null, rawWithIndices: null },\n    schema,\n    getModel,\n    allowedExtraRootKeys,\n  } = options;\n\n  let parent = options.parent;\n\n  const traverseMorphRelationTarget = async (visitor: Visitor, path: Path, entry: Data) => {\n    const targetSchema = getModel(entry.__type!);\n\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const traverseRelationTarget =\n    (schema: Model) => async (visitor: Visitor, path: Path, entry: Data) => {\n      const traverseOptions: TraverseOptions = {\n        schema,\n        path,\n        getModel,\n        parent,\n        allowedExtraRootKeys,\n      };\n\n      return traverseEntity(visitor, traverseOptions, entry);\n    };\n\n  const traverseMediaTarget = async (visitor: Visitor, path: Path, entry: Data) => {\n    const targetSchemaUID = 'plugin::upload.file';\n    const targetSchema = getModel(targetSchemaUID);\n\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const traverseComponent = async (visitor: Visitor, path: Path, schema: Model, entry: Data) => {\n    const traverseOptions: TraverseOptions = {\n      schema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const visitDynamicZoneEntry = async (visitor: Visitor, path: Path, entry: Data) => {\n    const targetSchema = getModel(entry.__component!);\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  // End recursion\n  if (!isObject(entity) || isNil(schema)) {\n    return entity;\n  }\n\n  // Don't mutate the original entity object\n  // only clone at 1st level as the next level will get clone when traversed\n  const copy = clone(entity);\n  const visitorUtils = createVisitorUtils({ data: copy });\n\n  const keys = Object.keys(copy);\n  for (let i = 0; i < keys.length; i += 1) {\n    const key = keys[i];\n    // Retrieve the attribute definition associated to the key from the schema\n    const attribute = schema.attributes[key] as AnyAttribute | undefined;\n\n    const newPath = { ...path };\n\n    newPath.raw = isNil(path.raw) ? key : `${path.raw}.${key}`;\n    newPath.rawWithIndices = isNil(path.rawWithIndices) ? key : `${path.rawWithIndices}.${key}`;\n\n    if (!isNil(attribute)) {\n      newPath.attribute = isNil(path.attribute) ? key : `${path.attribute}.${key}`;\n    }\n\n    // Visit the current attribute\n    const visitorOptions: VisitorOptions = {\n      data: copy,\n      schema,\n      key,\n      value: copy[key],\n      attribute,\n      path: newPath,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    await visitor(visitorOptions, visitorUtils);\n\n    // Extract the value for the current key (after calling the visitor)\n    const value = copy[key];\n\n    // Ignore Nil values or attributes\n    if (isNil(value) || isNil(attribute)) {\n      continue;\n    }\n\n    if (isRelationalAttribute(attribute)) {\n      parent = { schema, key, attribute, path: newPath };\n      const isMorphRelation = attribute.relation.toLowerCase().startsWith('morph');\n\n      const method = isMorphRelation\n        ? traverseMorphRelationTarget\n        : traverseRelationTarget(getModel(attribute.target!));\n\n      if (isArray(value)) {\n        // Process array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return method(visitor, arrayPath, item);\n          })\n        );\n      } else {\n        copy[key] = await method(visitor, newPath, value as Data);\n      }\n\n      continue;\n    }\n\n    if (isMediaAttribute(attribute)) {\n      parent = { schema, key, attribute, path: newPath };\n\n      if (isArray(value)) {\n        // Process media array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return traverseMediaTarget(visitor, arrayPath, item);\n          })\n        );\n      } else {\n        copy[key] = await traverseMediaTarget(visitor, newPath, value as Data);\n      }\n\n      continue;\n    }\n\n    if (attribute.type === 'component') {\n      parent = { schema, key, attribute, path: newPath };\n      const targetSchema = getModel(attribute.component);\n\n      if (isArray(value)) {\n        // Process component array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return traverseComponent(visitor, arrayPath, targetSchema, item);\n          })\n        );\n      } else {\n        copy[key] = await traverseComponent(visitor, newPath, targetSchema, value as Data);\n      }\n\n      continue;\n    }\n\n    if (attribute.type === 'dynamiczone' && isArray(value)) {\n      parent = { schema, key, attribute, path: newPath };\n\n      // Process dynamic zone items in parallel with ordered error handling\n      copy[key] = await parallelWithOrderedErrors(\n        value.map((item, i) => {\n          const arrayPath = {\n            ...newPath,\n            rawWithIndices: isNil(newPath.rawWithIndices)\n              ? `${i}`\n              : `${newPath.rawWithIndices}.${i}`,\n          };\n          return visitDynamicZoneEntry(visitor, arrayPath, item);\n        })\n      );\n\n      continue;\n    }\n  }\n\n  return copy;\n};\n\nconst createVisitorUtils = ({ data }: { data: Data }) => ({\n  remove(key: string) {\n    delete data[key];\n  },\n\n  set(key: string, value: Data) {\n    data[key] = value;\n  },\n});\n\nexport default curry(traverseEntity);\n"],"names":["parallelWithOrderedErrors","promises","results","Promise","allSettled","i","length","result","status","reason","map","r","value","traverseEntity","visitor","options","entity","path","raw","attribute","rawWithIndices","schema","getModel","allowedExtraRootKeys","parent","traverseMorphRelationTarget","entry","targetSchema","__type","traverseOptions","traverseRelationTarget","traverseMediaTarget","targetSchemaUID","traverseComponent","visitDynamicZoneEntry","__component","isObject","isNil","copy","clone","visitorUtils","createVisitorUtils","data","keys","Object","key","attributes","newPath","visitorOptions","isRelationalAttribute","isMorphRelation","relation","toLowerCase","startsWith","method","target","isArray","item","arrayPath","isMediaAttribute","type","component","remove","set","curry"],"mappings":"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"}
+{"version":3,"file":"traverse-entity.mjs","sources":["../src/traverse-entity.ts"],"sourcesContent":["import { clone, isObject, isArray, isNil, curry } from 'lodash/fp';\n\nimport type { Attribute, AnyAttribute, Model, Data } from './types';\nimport { isRelationalAttribute, isMediaAttribute } from './content-types';\n\n/**\n * Execute promises in parallel but throw errors in array index order.\n */\nconst parallelWithOrderedErrors = async <T>(promises: Promise<T>[]): Promise<T[]> => {\n  const results = await Promise.allSettled(promises);\n\n  // Throw first error in array index order (matches sequential behavior)\n  for (let i = 0; i < results.length; i += 1) {\n    const result = results[i];\n    if (result.status === 'rejected') {\n      throw result.reason;\n    }\n  }\n\n  return results.map((r) => (r as PromiseFulfilledResult<T>).value);\n};\n\nexport type VisitorUtils = ReturnType<typeof createVisitorUtils>;\n\nexport interface VisitorOptions {\n  data: Record<string, unknown>;\n  schema: Model;\n  key: string;\n  value: Data[keyof Data];\n  attribute?: AnyAttribute;\n  path: Path;\n  getModel(uid: string): Model;\n  parent?: Parent;\n  /** Extra root-level keys allowed (e.g. registered input params). Only used when path.attribute === null. */\n  allowedExtraRootKeys?: string[];\n}\n\nexport type Visitor = (visitorOptions: VisitorOptions, visitorUtils: VisitorUtils) => void;\n\nexport interface Path {\n  raw: string | null;\n  attribute: string | null;\n  rawWithIndices?: string | null;\n}\n\nexport interface TraverseOptions {\n  schema: Model;\n  path?: Path;\n  parent?: Parent;\n  getModel(uid: string): Model;\n  /** Extra root-level keys allowed (e.g. registered input params). Only used when path.attribute === null. */\n  allowedExtraRootKeys?: string[];\n}\n\nexport interface Parent {\n  attribute?: Attribute;\n  key: string | null;\n  path: Path;\n  schema: Model;\n}\n\nconst traverseEntity = async (\n  visitor: Visitor,\n  options: TraverseOptions,\n  entity: Data\n): Promise<Data> => {\n  const {\n    path = { raw: null, attribute: null, rawWithIndices: null },\n    schema,\n    getModel,\n    allowedExtraRootKeys,\n  } = options;\n\n  let parent = options.parent;\n\n  const traverseMorphRelationTarget = async (visitor: Visitor, path: Path, entry: Data) => {\n    const targetSchema = getModel(entry.__type!);\n\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const traverseRelationTarget =\n    (schema: Model) => async (visitor: Visitor, path: Path, entry: Data) => {\n      const traverseOptions: TraverseOptions = {\n        schema,\n        path,\n        getModel,\n        parent,\n        allowedExtraRootKeys,\n      };\n\n      return traverseEntity(visitor, traverseOptions, entry);\n    };\n\n  const traverseMediaTarget = async (visitor: Visitor, path: Path, entry: Data) => {\n    const targetSchemaUID = 'plugin::upload.file';\n    const targetSchema = getModel(targetSchemaUID);\n\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const traverseComponent = async (visitor: Visitor, path: Path, schema: Model, entry: Data) => {\n    const traverseOptions: TraverseOptions = {\n      schema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  const visitDynamicZoneEntry = async (visitor: Visitor, path: Path, entry: Data) => {\n    // A dynamic zone array can contain a `null` entry (for example a relation\n    // created inline inside a dynamic zone component can leave a null item).\n    // Reading `__component` on it crashed traversal; pass nil entries through\n    // untouched, consistent with how `traverseEntity` ends recursion on nil. (#24303)\n    if (isNil(entry)) {\n      return entry;\n    }\n\n    const targetSchema = getModel(entry.__component!);\n    const traverseOptions: TraverseOptions = {\n      schema: targetSchema,\n      path,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    return traverseEntity(visitor, traverseOptions, entry);\n  };\n\n  // End recursion\n  if (!isObject(entity) || isNil(schema)) {\n    return entity;\n  }\n\n  // Don't mutate the original entity object\n  // only clone at 1st level as the next level will get clone when traversed\n  const copy = clone(entity);\n  const visitorUtils = createVisitorUtils({ data: copy });\n\n  const keys = Object.keys(copy);\n  for (let i = 0; i < keys.length; i += 1) {\n    const key = keys[i];\n    // Retrieve the attribute definition associated to the key from the schema\n    const attribute = schema.attributes[key] as AnyAttribute | undefined;\n\n    const newPath = { ...path };\n\n    newPath.raw = isNil(path.raw) ? key : `${path.raw}.${key}`;\n    newPath.rawWithIndices = isNil(path.rawWithIndices) ? key : `${path.rawWithIndices}.${key}`;\n\n    if (!isNil(attribute)) {\n      newPath.attribute = isNil(path.attribute) ? key : `${path.attribute}.${key}`;\n    }\n\n    // Visit the current attribute\n    const visitorOptions: VisitorOptions = {\n      data: copy,\n      schema,\n      key,\n      value: copy[key],\n      attribute,\n      path: newPath,\n      getModel,\n      parent,\n      allowedExtraRootKeys,\n    };\n\n    await visitor(visitorOptions, visitorUtils);\n\n    // Extract the value for the current key (after calling the visitor)\n    const value = copy[key];\n\n    // Ignore Nil values or attributes\n    if (isNil(value) || isNil(attribute)) {\n      continue;\n    }\n\n    if (isRelationalAttribute(attribute)) {\n      parent = { schema, key, attribute, path: newPath };\n      const isMorphRelation = attribute.relation.toLowerCase().startsWith('morph');\n\n      const method = isMorphRelation\n        ? traverseMorphRelationTarget\n        : traverseRelationTarget(getModel(attribute.target!));\n\n      if (isArray(value)) {\n        // Process array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return method(visitor, arrayPath, item);\n          })\n        );\n      } else {\n        copy[key] = await method(visitor, newPath, value as Data);\n      }\n\n      continue;\n    }\n\n    if (isMediaAttribute(attribute)) {\n      parent = { schema, key, attribute, path: newPath };\n\n      if (isArray(value)) {\n        // Process media array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return traverseMediaTarget(visitor, arrayPath, item);\n          })\n        );\n      } else {\n        copy[key] = await traverseMediaTarget(visitor, newPath, value as Data);\n      }\n\n      continue;\n    }\n\n    if (attribute.type === 'component') {\n      parent = { schema, key, attribute, path: newPath };\n      const targetSchema = getModel(attribute.component);\n\n      if (isArray(value)) {\n        // Process component array items in parallel with ordered error handling\n        copy[key] = await parallelWithOrderedErrors(\n          value.map((item, i) => {\n            const arrayPath = {\n              ...newPath,\n              rawWithIndices: isNil(newPath.rawWithIndices)\n                ? `${i}`\n                : `${newPath.rawWithIndices}.${i}`,\n            };\n            return traverseComponent(visitor, arrayPath, targetSchema, item);\n          })\n        );\n      } else {\n        copy[key] = await traverseComponent(visitor, newPath, targetSchema, value as Data);\n      }\n\n      continue;\n    }\n\n    if (attribute.type === 'dynamiczone' && isArray(value)) {\n      parent = { schema, key, attribute, path: newPath };\n\n      // Process dynamic zone items in parallel with ordered error handling\n      copy[key] = await parallelWithOrderedErrors(\n        value.map((item, i) => {\n          const arrayPath = {\n            ...newPath,\n            rawWithIndices: isNil(newPath.rawWithIndices)\n              ? `${i}`\n              : `${newPath.rawWithIndices}.${i}`,\n          };\n          return visitDynamicZoneEntry(visitor, arrayPath, item);\n        })\n      );\n\n      continue;\n    }\n  }\n\n  return copy;\n};\n\nconst createVisitorUtils = ({ data }: { data: Data }) => ({\n  remove(key: string) {\n    delete data[key];\n  },\n\n  set(key: string, value: Data) {\n    data[key] = value;\n  },\n});\n\nexport default curry(traverseEntity);\n"],"names":["parallelWithOrderedErrors","promises","results","Promise","allSettled","i","length","result","status","reason","map","r","value","traverseEntity","visitor","options","entity","path","raw","attribute","rawWithIndices","schema","getModel","allowedExtraRootKeys","parent","traverseMorphRelationTarget","entry","targetSchema","__type","traverseOptions","traverseRelationTarget","traverseMediaTarget","targetSchemaUID","traverseComponent","visitDynamicZoneEntry","isNil","__component","isObject","copy","clone","visitorUtils","createVisitorUtils","data","keys","Object","key","attributes","newPath","visitorOptions","isRelationalAttribute","isMorphRelation","relation","toLowerCase","startsWith","method","target","isArray","item","arrayPath","isMediaAttribute","type","component","remove","set","curry"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import type * as Koa from 'koa';
 type ID = number | string;
 export type Data = {
     id?: ID;
@@ -53,30 +52,6 @@ export interface Model {
     privateAttributes?: string[];
     attributes: Record<string, AnyAttribute>;
 }
-declare module 'koa' {
-    interface Request extends Koa.BaseRequest {
-        route: RouteInfo;
-    }
-    interface ExtendableContext {
-        ok: (response?: string | object, details?: object) => Koa.Context;
-        created: (response?: string | object, details?: object) => Koa.Context;
-        noContent: (response?: string | object, details?: object) => Koa.Context;
-        badRequest: (response?: string | object, details?: object) => Koa.Context;
-        unauthorized: (response?: string | object, details?: object) => Koa.Context;
-        forbidden: (response?: string | object, details?: object) => Koa.Context;
-        notFound: (response?: string | object, details?: object) => Koa.Context;
-        locked: (response?: string | object, details?: object) => Koa.Context;
-        internalServerError: (response?: string | object, details?: object) => Koa.Context;
-        notImplemented: (response?: string | object, data?: Record<string, unknown>) => Koa.Context;
-    }
-}
-export interface RouteInfo {
-    endpoint: string;
-    controller: string;
-    action: string;
-    verb: string;
-    plugin: string;
-}
 export type WithRequired<T, K extends keyof T> = T & {
     [P in K]-?: T[P];
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAGhC,KAAK,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1B,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;CACzF,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EACA,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,GACT,YAAY,GACZ,OAAO,GACP,SAAS,GACT,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,GACT,MAAM,GACN,QAAQ,GACR,KAAK,GACL,UAAU,GACV,OAAO,GACP,OAAO,CAAC;CACb;AAED,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEnD,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,aAAa,GAAG,WAAW,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,OAAQ,SAAQ,GAAG,CAAC,WAAW;QACvC,KAAK,EAAE,SAAS,CAAC;KAClB;IAED,UAAU,iBAAiB;QACzB,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QAClE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACvE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACzE,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QAC1E,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QAC5E,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACzE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACxE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACtE,mBAAmB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC;QACnF,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC;KAC7F;CACF;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,KAAK,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1B,MAAM,MAAM,IAAI,GAAG;IACjB,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;CACzF,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EACA,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,GACT,YAAY,GACZ,OAAO,GACP,SAAS,GACT,MAAM,GACN,MAAM,GACN,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,GACT,MAAM,GACN,QAAQ,GACR,KAAK,GACL,UAAU,GACV,OAAO,GACP,OAAO,CAAC;CACb;AAED,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEnD,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,aAAa,GAAG,WAAW,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/user-agent.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Minimal, dependency-free User-Agent parsing.
+ *
+ * This is intentionally heuristic and only aims to produce a human-readable label
+ * (e.g. "Chrome on macOS") for displaying active sessions/devices. It is not a full
+ * UA parser and should not be relied upon for feature detection.
+ */
+export interface ParsedUserAgent {
+    browser?: string;
+    os?: string;
+    /** Human-readable label combining browser and OS, e.g. "Chrome on macOS". */
+    deviceName?: string;
+}
+/**
+ * Parses a User-Agent string into a best-effort browser/OS and a display label.
+ * Returns an empty object when the input is missing or unrecognized.
+ */
+export declare const parseUserAgent: (userAgent?: string | null) => ParsedUserAgent;
+/**
+ * Convenience helper returning only the human-readable device label, or undefined.
+ */
+export declare const getDeviceName: (userAgent?: string | null) => string | undefined;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../src/user-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwCD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,GAAG,IAAI,KAAG,eAqB1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAC7B,CAAC"}

package/dist/user-agent.js

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * Minimal, dependency-free User-Agent parsing.
+ *
+ * This is intentionally heuristic and only aims to produce a human-readable label
+ * (e.g. "Chrome on macOS") for displaying active sessions/devices. It is not a full
+ * UA parser and should not be relied upon for feature detection.
+ */ /**
+ * Upper bound on the User-Agent length we are willing to scan. Real-world UA
+ * strings are comfortably under this, and browser/OS tokens always appear early,
+ * so clamping protects against pathologically large attacker-controlled headers
+ * without losing accuracy for legitimate clients.
+ */ const MAX_UA_LENGTH = 1024;
+const detectBrowser = (ua)=>{
+    // Order matters: more specific tokens must be checked first.
+    if (/\bEdg(?:e|A|iOS)?\//.test(ua)) return 'Edge';
+    if (/\b(?:OPR|Opera)\//.test(ua)) return 'Opera';
+    if (/\b(?:SamsungBrowser)\//.test(ua)) return 'Samsung Internet';
+    // Chromium forks below ship a "Chrome/" token too, so they must be matched
+    // before the generic Chrome check or they'd all collapse into "Chrome".
+    if (/\bVivaldi\//.test(ua)) return 'Vivaldi';
+    if (/\b(?:YaBrowser|Yowser)\//.test(ua)) return 'Yandex Browser';
+    if (/\bBrave\//.test(ua)) return 'Brave';
+    if (/\b(?:Firefox|FxiOS)\//.test(ua)) return 'Firefox';
+    if (/\b(?:Chrome|CriOS|Chromium)\//.test(ua)) return 'Chrome';
+    // Safari ships "Safari/xxx" but so do Chrome/Edge; only treat as Safari when no Chrome token.
+    if (/\bVersion\/[\d.]+ (?:Mobile\/\S+ )?Safari\//.test(ua) || /\bSafari\//.test(ua)) {
+        return 'Safari';
+    }
+    return undefined;
+};
+const detectOS = (ua)=>{
+    if (/\bWindows NT\b/.test(ua)) return 'Windows';
+    if (/\b(?:iPhone|iPad|iPod)\b/.test(ua)) return 'iOS';
+    if (/\bAndroid\b/.test(ua)) return 'Android';
+    // "Mac OS X" appears on iOS too, so this must come after the iOS check.
+    if (/\b(?:Macintosh|Mac OS X)\b/.test(ua)) return 'macOS';
+    if (/\bCrOS\b/.test(ua)) return 'ChromeOS';
+    if (/\bLinux\b/.test(ua)) return 'Linux';
+    return undefined;
+};
+/**
+ * Parses a User-Agent string into a best-effort browser/OS and a display label.
+ * Returns an empty object when the input is missing or unrecognized.
+ */ const parseUserAgent = (userAgent)=>{
+    if (!userAgent || typeof userAgent !== 'string') {
+        return {};
+    }
+    // Clamp before scanning so an oversized header cannot drive the regex work.
+    const ua = userAgent.length > MAX_UA_LENGTH ? userAgent.slice(0, MAX_UA_LENGTH) : userAgent;
+    const browser = detectBrowser(ua);
+    const os = detectOS(ua);
+    let deviceName;
+    if (browser && os) {
+        deviceName = `${browser} on ${os}`;
+    } else if (browser) {
+        deviceName = browser;
+    } else if (os) {
+        deviceName = os;
+    }
+    return {
+        browser,
+        os,
+        deviceName
+    };
+};
+/**
+ * Convenience helper returning only the human-readable device label, or undefined.
+ */ const getDeviceName = (userAgent)=>parseUserAgent(userAgent).deviceName;
+
+exports.getDeviceName = getDeviceName;
+exports.parseUserAgent = parseUserAgent;
+//# sourceMappingURL=user-agent.js.map

package/dist/user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.js","sources":["../src/user-agent.ts"],"sourcesContent":["/**\n * Minimal, dependency-free User-Agent parsing.\n *\n * This is intentionally heuristic and only aims to produce a human-readable label\n * (e.g. \"Chrome on macOS\") for displaying active sessions/devices. It is not a full\n * UA parser and should not be relied upon for feature detection.\n */\n\nexport interface ParsedUserAgent {\n  browser?: string;\n  os?: string;\n  /** Human-readable label combining browser and OS, e.g. \"Chrome on macOS\". */\n  deviceName?: string;\n}\n\n/**\n * Upper bound on the User-Agent length we are willing to scan. Real-world UA\n * strings are comfortably under this, and browser/OS tokens always appear early,\n * so clamping protects against pathologically large attacker-controlled headers\n * without losing accuracy for legitimate clients.\n */\nconst MAX_UA_LENGTH = 1024;\n\nconst detectBrowser = (ua: string): string | undefined => {\n  // Order matters: more specific tokens must be checked first.\n  if (/\\bEdg(?:e|A|iOS)?\\//.test(ua)) return 'Edge';\n  if (/\\b(?:OPR|Opera)\\//.test(ua)) return 'Opera';\n  if (/\\b(?:SamsungBrowser)\\//.test(ua)) return 'Samsung Internet';\n  // Chromium forks below ship a \"Chrome/\" token too, so they must be matched\n  // before the generic Chrome check or they'd all collapse into \"Chrome\".\n  if (/\\bVivaldi\\//.test(ua)) return 'Vivaldi';\n  if (/\\b(?:YaBrowser|Yowser)\\//.test(ua)) return 'Yandex Browser';\n  if (/\\bBrave\\//.test(ua)) return 'Brave';\n  if (/\\b(?:Firefox|FxiOS)\\//.test(ua)) return 'Firefox';\n  if (/\\b(?:Chrome|CriOS|Chromium)\\//.test(ua)) return 'Chrome';\n  // Safari ships \"Safari/xxx\" but so do Chrome/Edge; only treat as Safari when no Chrome token.\n  if (/\\bVersion\\/[\\d.]+ (?:Mobile\\/\\S+ )?Safari\\//.test(ua) || /\\bSafari\\//.test(ua)) {\n    return 'Safari';\n  }\n  return undefined;\n};\n\nconst detectOS = (ua: string): string | undefined => {\n  if (/\\bWindows NT\\b/.test(ua)) return 'Windows';\n  if (/\\b(?:iPhone|iPad|iPod)\\b/.test(ua)) return 'iOS';\n  if (/\\bAndroid\\b/.test(ua)) return 'Android';\n  // \"Mac OS X\" appears on iOS too, so this must come after the iOS check.\n  if (/\\b(?:Macintosh|Mac OS X)\\b/.test(ua)) return 'macOS';\n  if (/\\bCrOS\\b/.test(ua)) return 'ChromeOS';\n  if (/\\bLinux\\b/.test(ua)) return 'Linux';\n  return undefined;\n};\n\n/**\n * Parses a User-Agent string into a best-effort browser/OS and a display label.\n * Returns an empty object when the input is missing or unrecognized.\n */\nexport const parseUserAgent = (userAgent?: string | null): ParsedUserAgent => {\n  if (!userAgent || typeof userAgent !== 'string') {\n    return {};\n  }\n\n  // Clamp before scanning so an oversized header cannot drive the regex work.\n  const ua = userAgent.length > MAX_UA_LENGTH ? userAgent.slice(0, MAX_UA_LENGTH) : userAgent;\n\n  const browser = detectBrowser(ua);\n  const os = detectOS(ua);\n\n  let deviceName: string | undefined;\n  if (browser && os) {\n    deviceName = `${browser} on ${os}`;\n  } else if (browser) {\n    deviceName = browser;\n  } else if (os) {\n    deviceName = os;\n  }\n\n  return { browser, os, deviceName };\n};\n\n/**\n * Convenience helper returning only the human-readable device label, or undefined.\n */\nexport const getDeviceName = (userAgent?: string | null): string | undefined =>\n  parseUserAgent(userAgent).deviceName;\n"],"names":["MAX_UA_LENGTH","detectBrowser","ua","test","undefined","detectOS","parseUserAgent","userAgent","length","slice","browser","os","deviceName","getDeviceName"],"mappings":";;AAAA;;;;;;;;;;;AAoBC,IACD,MAAMA,aAAAA,GAAgB,IAAA;AAEtB,MAAMC,gBAAgB,CAACC,EAAAA,GAAAA;;AAErB,IAAA,IAAI,qBAAA,CAAsBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,MAAA;AAC3C,IAAA,IAAI,mBAAA,CAAoBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AACzC,IAAA,IAAI,wBAAA,CAAyBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,kBAAA;;;AAG9C,IAAA,IAAI,aAAA,CAAcC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AACnC,IAAA,IAAI,0BAAA,CAA2BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,gBAAA;AAChD,IAAA,IAAI,WAAA,CAAYC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AACjC,IAAA,IAAI,uBAAA,CAAwBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AAC7C,IAAA,IAAI,+BAAA,CAAgCC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,QAAA;;AAErD,IAAA,IAAI,8CAA8CC,IAAI,CAACD,OAAO,YAAA,CAAaC,IAAI,CAACD,EAAAA,CAAAA,EAAK;QACnF,OAAO,QAAA;AACT,IAAA;IACA,OAAOE,SAAAA;AACT,CAAA;AAEA,MAAMC,WAAW,CAACH,EAAAA,GAAAA;AAChB,IAAA,IAAI,gBAAA,CAAiBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AACtC,IAAA,IAAI,0BAAA,CAA2BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,KAAA;AAChD,IAAA,IAAI,aAAA,CAAcC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;;AAEnC,IAAA,IAAI,4BAAA,CAA6BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AAClD,IAAA,IAAI,UAAA,CAAWC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,UAAA;AAChC,IAAA,IAAI,WAAA,CAAYC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;IACjC,OAAOE,SAAAA;AACT,CAAA;AAEA;;;IAIO,MAAME,cAAAA,GAAiB,CAACC,SAAAA,GAAAA;AAC7B,IAAA,IAAI,CAACA,SAAAA,IAAa,OAAOA,SAAAA,KAAc,QAAA,EAAU;AAC/C,QAAA,OAAO,EAAC;AACV,IAAA;;IAGA,MAAML,EAAAA,GAAKK,UAAUC,MAAM,GAAGR,gBAAgBO,SAAAA,CAAUE,KAAK,CAAC,CAAA,EAAGT,aAAAA,CAAAA,GAAiBO,SAAAA;AAElF,IAAA,MAAMG,UAAUT,aAAAA,CAAcC,EAAAA,CAAAA;AAC9B,IAAA,MAAMS,KAAKN,QAAAA,CAASH,EAAAA,CAAAA;IAEpB,IAAIU,UAAAA;AACJ,IAAA,IAAIF,WAAWC,EAAAA,EAAI;AACjBC,QAAAA,UAAAA,GAAa,CAAA,EAAGF,OAAAA,CAAQ,IAAI,EAAEC,EAAAA,CAAAA,CAAI;AACpC,IAAA,CAAA,MAAO,IAAID,OAAAA,EAAS;QAClBE,UAAAA,GAAaF,OAAAA;AACf,IAAA,CAAA,MAAO,IAAIC,EAAAA,EAAI;QACbC,UAAAA,GAAaD,EAAAA;AACf,IAAA;IAEA,OAAO;AAAED,QAAAA,OAAAA;AAASC,QAAAA,EAAAA;AAAIC,QAAAA;AAAW,KAAA;AACnC;AAEA;;UAGaC,aAAAA,GAAgB,CAACN,YAC5BD,cAAAA,CAAeC,SAAAA,CAAAA,CAAWK;;;;;"}

package/dist/user-agent.mjs

@@ -0,0 +1,71 @@
+/**
+ * Minimal, dependency-free User-Agent parsing.
+ *
+ * This is intentionally heuristic and only aims to produce a human-readable label
+ * (e.g. "Chrome on macOS") for displaying active sessions/devices. It is not a full
+ * UA parser and should not be relied upon for feature detection.
+ */ /**
+ * Upper bound on the User-Agent length we are willing to scan. Real-world UA
+ * strings are comfortably under this, and browser/OS tokens always appear early,
+ * so clamping protects against pathologically large attacker-controlled headers
+ * without losing accuracy for legitimate clients.
+ */ const MAX_UA_LENGTH = 1024;
+const detectBrowser = (ua)=>{
+    // Order matters: more specific tokens must be checked first.
+    if (/\bEdg(?:e|A|iOS)?\//.test(ua)) return 'Edge';
+    if (/\b(?:OPR|Opera)\//.test(ua)) return 'Opera';
+    if (/\b(?:SamsungBrowser)\//.test(ua)) return 'Samsung Internet';
+    // Chromium forks below ship a "Chrome/" token too, so they must be matched
+    // before the generic Chrome check or they'd all collapse into "Chrome".
+    if (/\bVivaldi\//.test(ua)) return 'Vivaldi';
+    if (/\b(?:YaBrowser|Yowser)\//.test(ua)) return 'Yandex Browser';
+    if (/\bBrave\//.test(ua)) return 'Brave';
+    if (/\b(?:Firefox|FxiOS)\//.test(ua)) return 'Firefox';
+    if (/\b(?:Chrome|CriOS|Chromium)\//.test(ua)) return 'Chrome';
+    // Safari ships "Safari/xxx" but so do Chrome/Edge; only treat as Safari when no Chrome token.
+    if (/\bVersion\/[\d.]+ (?:Mobile\/\S+ )?Safari\//.test(ua) || /\bSafari\//.test(ua)) {
+        return 'Safari';
+    }
+    return undefined;
+};
+const detectOS = (ua)=>{
+    if (/\bWindows NT\b/.test(ua)) return 'Windows';
+    if (/\b(?:iPhone|iPad|iPod)\b/.test(ua)) return 'iOS';
+    if (/\bAndroid\b/.test(ua)) return 'Android';
+    // "Mac OS X" appears on iOS too, so this must come after the iOS check.
+    if (/\b(?:Macintosh|Mac OS X)\b/.test(ua)) return 'macOS';
+    if (/\bCrOS\b/.test(ua)) return 'ChromeOS';
+    if (/\bLinux\b/.test(ua)) return 'Linux';
+    return undefined;
+};
+/**
+ * Parses a User-Agent string into a best-effort browser/OS and a display label.
+ * Returns an empty object when the input is missing or unrecognized.
+ */ const parseUserAgent = (userAgent)=>{
+    if (!userAgent || typeof userAgent !== 'string') {
+        return {};
+    }
+    // Clamp before scanning so an oversized header cannot drive the regex work.
+    const ua = userAgent.length > MAX_UA_LENGTH ? userAgent.slice(0, MAX_UA_LENGTH) : userAgent;
+    const browser = detectBrowser(ua);
+    const os = detectOS(ua);
+    let deviceName;
+    if (browser && os) {
+        deviceName = `${browser} on ${os}`;
+    } else if (browser) {
+        deviceName = browser;
+    } else if (os) {
+        deviceName = os;
+    }
+    return {
+        browser,
+        os,
+        deviceName
+    };
+};
+/**
+ * Convenience helper returning only the human-readable device label, or undefined.
+ */ const getDeviceName = (userAgent)=>parseUserAgent(userAgent).deviceName;
+
+export { getDeviceName, parseUserAgent };
+//# sourceMappingURL=user-agent.mjs.map

package/dist/user-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.mjs","sources":["../src/user-agent.ts"],"sourcesContent":["/**\n * Minimal, dependency-free User-Agent parsing.\n *\n * This is intentionally heuristic and only aims to produce a human-readable label\n * (e.g. \"Chrome on macOS\") for displaying active sessions/devices. It is not a full\n * UA parser and should not be relied upon for feature detection.\n */\n\nexport interface ParsedUserAgent {\n  browser?: string;\n  os?: string;\n  /** Human-readable label combining browser and OS, e.g. \"Chrome on macOS\". */\n  deviceName?: string;\n}\n\n/**\n * Upper bound on the User-Agent length we are willing to scan. Real-world UA\n * strings are comfortably under this, and browser/OS tokens always appear early,\n * so clamping protects against pathologically large attacker-controlled headers\n * without losing accuracy for legitimate clients.\n */\nconst MAX_UA_LENGTH = 1024;\n\nconst detectBrowser = (ua: string): string | undefined => {\n  // Order matters: more specific tokens must be checked first.\n  if (/\\bEdg(?:e|A|iOS)?\\//.test(ua)) return 'Edge';\n  if (/\\b(?:OPR|Opera)\\//.test(ua)) return 'Opera';\n  if (/\\b(?:SamsungBrowser)\\//.test(ua)) return 'Samsung Internet';\n  // Chromium forks below ship a \"Chrome/\" token too, so they must be matched\n  // before the generic Chrome check or they'd all collapse into \"Chrome\".\n  if (/\\bVivaldi\\//.test(ua)) return 'Vivaldi';\n  if (/\\b(?:YaBrowser|Yowser)\\//.test(ua)) return 'Yandex Browser';\n  if (/\\bBrave\\//.test(ua)) return 'Brave';\n  if (/\\b(?:Firefox|FxiOS)\\//.test(ua)) return 'Firefox';\n  if (/\\b(?:Chrome|CriOS|Chromium)\\//.test(ua)) return 'Chrome';\n  // Safari ships \"Safari/xxx\" but so do Chrome/Edge; only treat as Safari when no Chrome token.\n  if (/\\bVersion\\/[\\d.]+ (?:Mobile\\/\\S+ )?Safari\\//.test(ua) || /\\bSafari\\//.test(ua)) {\n    return 'Safari';\n  }\n  return undefined;\n};\n\nconst detectOS = (ua: string): string | undefined => {\n  if (/\\bWindows NT\\b/.test(ua)) return 'Windows';\n  if (/\\b(?:iPhone|iPad|iPod)\\b/.test(ua)) return 'iOS';\n  if (/\\bAndroid\\b/.test(ua)) return 'Android';\n  // \"Mac OS X\" appears on iOS too, so this must come after the iOS check.\n  if (/\\b(?:Macintosh|Mac OS X)\\b/.test(ua)) return 'macOS';\n  if (/\\bCrOS\\b/.test(ua)) return 'ChromeOS';\n  if (/\\bLinux\\b/.test(ua)) return 'Linux';\n  return undefined;\n};\n\n/**\n * Parses a User-Agent string into a best-effort browser/OS and a display label.\n * Returns an empty object when the input is missing or unrecognized.\n */\nexport const parseUserAgent = (userAgent?: string | null): ParsedUserAgent => {\n  if (!userAgent || typeof userAgent !== 'string') {\n    return {};\n  }\n\n  // Clamp before scanning so an oversized header cannot drive the regex work.\n  const ua = userAgent.length > MAX_UA_LENGTH ? userAgent.slice(0, MAX_UA_LENGTH) : userAgent;\n\n  const browser = detectBrowser(ua);\n  const os = detectOS(ua);\n\n  let deviceName: string | undefined;\n  if (browser && os) {\n    deviceName = `${browser} on ${os}`;\n  } else if (browser) {\n    deviceName = browser;\n  } else if (os) {\n    deviceName = os;\n  }\n\n  return { browser, os, deviceName };\n};\n\n/**\n * Convenience helper returning only the human-readable device label, or undefined.\n */\nexport const getDeviceName = (userAgent?: string | null): string | undefined =>\n  parseUserAgent(userAgent).deviceName;\n"],"names":["MAX_UA_LENGTH","detectBrowser","ua","test","undefined","detectOS","parseUserAgent","userAgent","length","slice","browser","os","deviceName","getDeviceName"],"mappings":"AAAA;;;;;;;;;;;AAoBC,IACD,MAAMA,aAAAA,GAAgB,IAAA;AAEtB,MAAMC,gBAAgB,CAACC,EAAAA,GAAAA;;AAErB,IAAA,IAAI,qBAAA,CAAsBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,MAAA;AAC3C,IAAA,IAAI,mBAAA,CAAoBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AACzC,IAAA,IAAI,wBAAA,CAAyBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,kBAAA;;;AAG9C,IAAA,IAAI,aAAA,CAAcC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AACnC,IAAA,IAAI,0BAAA,CAA2BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,gBAAA;AAChD,IAAA,IAAI,WAAA,CAAYC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AACjC,IAAA,IAAI,uBAAA,CAAwBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AAC7C,IAAA,IAAI,+BAAA,CAAgCC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,QAAA;;AAErD,IAAA,IAAI,8CAA8CC,IAAI,CAACD,OAAO,YAAA,CAAaC,IAAI,CAACD,EAAAA,CAAAA,EAAK;QACnF,OAAO,QAAA;AACT,IAAA;IACA,OAAOE,SAAAA;AACT,CAAA;AAEA,MAAMC,WAAW,CAACH,EAAAA,GAAAA;AAChB,IAAA,IAAI,gBAAA,CAAiBC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;AACtC,IAAA,IAAI,0BAAA,CAA2BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,KAAA;AAChD,IAAA,IAAI,aAAA,CAAcC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,SAAA;;AAEnC,IAAA,IAAI,4BAAA,CAA6BC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;AAClD,IAAA,IAAI,UAAA,CAAWC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,UAAA;AAChC,IAAA,IAAI,WAAA,CAAYC,IAAI,CAACD,EAAAA,CAAAA,EAAK,OAAO,OAAA;IACjC,OAAOE,SAAAA;AACT,CAAA;AAEA;;;IAIO,MAAME,cAAAA,GAAiB,CAACC,SAAAA,GAAAA;AAC7B,IAAA,IAAI,CAACA,SAAAA,IAAa,OAAOA,SAAAA,KAAc,QAAA,EAAU;AAC/C,QAAA,OAAO,EAAC;AACV,IAAA;;IAGA,MAAML,EAAAA,GAAKK,UAAUC,MAAM,GAAGR,gBAAgBO,SAAAA,CAAUE,KAAK,CAAC,CAAA,EAAGT,aAAAA,CAAAA,GAAiBO,SAAAA;AAElF,IAAA,MAAMG,UAAUT,aAAAA,CAAcC,EAAAA,CAAAA;AAC9B,IAAA,MAAMS,KAAKN,QAAAA,CAASH,EAAAA,CAAAA;IAEpB,IAAIU,UAAAA;AACJ,IAAA,IAAIF,WAAWC,EAAAA,EAAI;AACjBC,QAAAA,UAAAA,GAAa,CAAA,EAAGF,OAAAA,CAAQ,IAAI,EAAEC,EAAAA,CAAAA,CAAI;AACpC,IAAA,CAAA,MAAO,IAAID,OAAAA,EAAS;QAClBE,UAAAA,GAAaF,OAAAA;AACf,IAAA,CAAA,MAAO,IAAIC,EAAAA,EAAI;QACbC,UAAAA,GAAaD,EAAAA;AACf,IAAA;IAEA,OAAO;AAAED,QAAAA,OAAAA;AAASC,QAAAA,EAAAA;AAAIC,QAAAA;AAAW,KAAA;AACnC;AAEA;;UAGaC,aAAAA,GAAgB,CAACN,YAC5BD,cAAAA,CAAeC,SAAAA,CAAAA,CAAWK;;;;"}

package/dist/validate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAM1C,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAK3C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAMvC,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,MAAM,EAAE,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CACxD;AACD,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,QAAA,MAAM,mBAAmB,SAAU,UAAU;;mBA8FlC,OAAO,MAAM,EAAE,OAAO,CAAC,UACtB,KAAK,kCAC0B,OAAO;;;;;CA+KjD,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAM1C,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAK3C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAMvC,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,MAAM,EAAE,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CACxD;AACD,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,wBAAwB,GAAG,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,OAAO,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,QAAA,MAAM,mBAAmB,GAAI,MAAM,UAAU;;mBA8FlC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACtB,KAAK,kCAC0B,OAAO;;;;;CA+KjD,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/validate/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/validate/utils.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,kBAAmB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAG,KAOtF,CAAC;AAEF,eAAO,MAAM,UAAU,+BACjB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,KAC7B,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,GAAG,CAS/B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/validate/utils.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,GAAI,eAAe;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAG,KAOtF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC/C,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAC7B,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAS/B,CAAC"}

package/dist/validate/validators.d.ts

@@ -19,10 +19,10 @@ export declare const validateFields: (ctx?: Context | undefined, fields?: unknow
 export declare const defaultValidateFields: (ctx?: Context | undefined, fields?: unknown) => any;
 export declare const POPULATE_TRAVERSALS: string[];
 export declare const validatePopulate: (ctx?: PopulateContext | undefined, populate?: unknown, includes?: {
-    fields?: string[] | undefined;
-    sort?: string[] | undefined;
-    filters?: string[] | undefined;
-    populate?: string[] | undefined;
+    fields?: (typeof FIELDS_TRAVERSALS)[number][];
+    sort?: (typeof SORT_TRAVERSALS)[number][];
+    filters?: (typeof FILTER_TRAVERSALS)[number][];
+    populate?: (typeof POPULATE_TRAVERSALS)[number][];
 } | undefined) => any;
 export declare const defaultValidatePopulate: (ctx?: Context | undefined, populate?: unknown) => any;
 export {};

package/dist/validate/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/validate/validators.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIxD,UAAU,OAAO;IACf,MAAM,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;CACpC;AAED,UAAU,eAAgB,SAAQ,OAAO;IACvC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,iBAAiB,UAM7B,CAAC;AAEF,eAAO,MAAM,eAAe,uFAoD3B,CAAC;AAEF,eAAO,MAAM,sBAAsB,uDAEjC,CAAC;AAEH,eAAO,MAAM,eAAe,UAO3B,CAAC;AAEF,eAAO,MAAM,YAAY,oFA2ExB,CAAC;AAEF,eAAO,MAAM,mBAAmB,oDAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB,UAA0D,CAAC;AAEzF,eAAO,MAAM,cAAc,sFA0C1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,sDAEhC,CAAC;AAEH,eAAO,MAAM,mBAAmB,UAAwC,CAAC;AAEzE,eAAO,MAAM,gBAAgB;;;;;qBAiL5B,CAAC;AAEF,eAAO,MAAM,uBAAuB,wDAYlC,CAAC"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/validate/validators.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAa,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIxD,UAAU,OAAO;IACf,MAAM,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;CACpC;AAED,UAAU,eAAgB,SAAQ,OAAO;IACvC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,iBAAiB,UAM7B,CAAC;AAEF,eAAO,MAAM,eAAe,uFAoD3B,CAAC;AAEF,eAAO,MAAM,sBAAsB,uDAEjC,CAAC;AAEH,eAAO,MAAM,eAAe,UAO3B,CAAC;AAEF,eAAO,MAAM,YAAY,oFA2ExB,CAAC;AAEF,eAAO,MAAM,mBAAmB,oDAE9B,CAAC;AAEH,eAAO,MAAM,iBAAiB,UAA0D,CAAC;AAEzF,eAAO,MAAM,cAAc,sFA0C1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,sDAEhC,CAAC;AAsKH,eAAO,MAAM,mBAAmB,UAAwC,CAAC;AAEzE,eAAO,MAAM,gBAAgB;aAKd,CAAC,OAAO,iBAAiB,EAAE,MAAM,CAAC,EAAE;WACtC,CAAC,OAAO,eAAe,EAAE,MAAM,CAAC,EAAE;cAC/B,CAAC,OAAO,iBAAiB,EAAE,MAAM,CAAC,EAAE;eACnC,CAAC,OAAO,mBAAmB,EAAE,MAAM,CAAC,EAAE;qBA0LtD,CAAC;AAEF,eAAO,MAAM,uBAAuB,wDAYlC,CAAC"}

package/dist/validate/validators.js

@@ -200,6 +200,143 @@ const validateFields = utils.asyncCurry(async (ctx, fields, include)=>{
 const defaultValidateFields = utils.asyncCurry(async (ctx, fields)=>{
     return validateFields(ctx, fields, FIELDS_TRAVERSALS);
 });
+const isMorphLikeAttribute = (attribute)=>contentTypes.isDynamicZoneAttribute(attribute) || contentTypes.isMorphToRelationalAttribute(attribute);
+const isPopulatableAttribute = (attribute)=>!!attribute && [
+        'relation',
+        'dynamiczone',
+        'component',
+        'media'
+    ].includes(attribute.type);
+const isDotNotationPopulate = (populate)=>{
+    if (populate === '*') {
+        return false;
+    }
+    if (typeof populate === 'string') {
+        return true;
+    }
+    return Array.isArray(populate) && populate.length > 0 && populate.every((p)=>typeof p === 'string');
+};
+const flattenDotPopulatePaths = (populate)=>{
+    const items = Array.isArray(populate) ? populate : [
+        populate
+    ];
+    return items.flatMap((item)=>item.split(',').map((segment)=>fp.trim(segment)).filter(Boolean));
+};
+const validatePopulateDotPathSegments = ({ schema, getModel }, segments, pathPrefix)=>{
+    if (!segments.length) {
+        return;
+    }
+    const [head, ...tail] = segments;
+    const fullPath = pathPrefix ? `${pathPrefix}.${head}` : head;
+    const attribute = schema.attributes[head];
+    if (!attribute || !isPopulatableAttribute(attribute)) {
+        utils.throwInvalidKey({
+            key: head,
+            path: fullPath
+        });
+    }
+    if (!tail.length) {
+        return;
+    }
+    if (attribute.type === 'component') {
+        if (!attribute.component) {
+            utils.throwInvalidKey({
+                key: head,
+                path: fullPath
+            });
+        }
+        validatePopulateDotPathSegments({
+            schema: getModel(attribute.component),
+            getModel
+        }, tail, fullPath);
+        return;
+    }
+    if (attribute.type === 'relation') {
+        if (isMorphLikeAttribute(attribute)) {
+            utils.throwInvalidKey({
+                key: head,
+                path: fullPath
+            });
+        }
+        if (!attribute.target) {
+            utils.throwInvalidKey({
+                key: head,
+                path: fullPath
+            });
+        }
+        validatePopulateDotPathSegments({
+            schema: getModel(attribute.target),
+            getModel
+        }, tail, fullPath);
+        return;
+    }
+    if (attribute.type === 'media') {
+        utils.throwInvalidKey({
+            key: head,
+            path: fullPath
+        });
+    }
+    if (attribute.type === 'dynamiczone') {
+        const [nextSegment, ...rest] = tail;
+        const nextPath = `${fullPath}.${nextSegment}`;
+        const candidates = (attribute.components ?? []).map((uid)=>getModel(uid)).filter((model)=>model?.attributes?.[nextSegment]);
+        if (!candidates.length) {
+            utils.throwInvalidKey({
+                key: nextSegment,
+                path: nextPath
+            });
+        }
+        let validated = false;
+        for (const componentSchema of candidates){
+            const nestedAttribute = componentSchema.attributes[nextSegment];
+            try {
+                if (!rest.length) {
+                    if (nestedAttribute) {
+                        validated = true;
+                        break;
+                    }
+                } else if (nestedAttribute?.type === 'component' && nestedAttribute.component) {
+                    validatePopulateDotPathSegments({
+                        schema: getModel(nestedAttribute.component),
+                        getModel
+                    }, rest, nextPath);
+                    validated = true;
+                    break;
+                } else if (nestedAttribute?.type === 'relation' && !isMorphLikeAttribute(nestedAttribute) && nestedAttribute.target) {
+                    validatePopulateDotPathSegments({
+                        schema: getModel(nestedAttribute.target),
+                        getModel
+                    }, rest, nextPath);
+                    validated = true;
+                    break;
+                }
+            } catch  {
+            // Try the next dynamic-zone component type.
+            }
+        }
+        if (!validated) {
+            utils.throwInvalidKey({
+                key: nextSegment,
+                path: nextPath
+            });
+        }
+    }
+};
+const validatePopulateDotPaths = (ctx, populate)=>{
+    for (const path of flattenDotPopulatePaths(populate)){
+        const segments = path.split('.').map((segment)=>fp.trim(segment)).filter(Boolean);
+        validatePopulateDotPathSegments(ctx, segments, '');
+    }
+};
+const validateMorphLikeNestedPopulate = (populateValue, { path })=>{
+    // Keep in sync with convert-query-params polymorphic nested populate handling.
+    if (!fp.isNil(populateValue) && populateValue !== '*') {
+        utils.throwInvalidKey({
+            key: 'populate',
+            path
+        });
+    }
+};
 const POPULATE_TRAVERSALS = [
     'nonAttributesOperators',
     'private'
@@ -208,6 +345,16 @@ const validatePopulate = utils.asyncCurry(async (ctx, populate, includes)=>{
     if (!ctx.schema) {
         throw new Error('Missing schema in defaultValidatePopulate');
     }
+    if (isDotNotationPopulate(populate)) {
+        validatePopulateDotPaths({
+            schema: ctx.schema,
+            getModel: ctx.getModel
+        }, populate);
+        if (includes?.populate?.includes('private')) {
+            return queryPopulate(throwPrivate, ctx)(populate);
+        }
+        return populate;
+    }
     // Build the list of functions conditionally based on the include array
     const functionsToApply = [];
     // Always include the main traversal function
@@ -224,6 +371,11 @@ const validatePopulate = utils.asyncCurry(async (ctx, populate, includes)=>{
                 'component',
                 'media'
             ].includes(attribute.type);
+            if (isMorphLikeAttribute(attribute) && fp.isObject(value) && 'populate' in value) {
+                validateMorphLikeNestedPopulate(value.populate, {
+                    path: path.raw
+                });
+            }
             // Throw on non-populate attributes
             if (!isPopulatableAttribute) {
                 utils.throwInvalidKey({