@socketsecurity/lib 0.0.0 → 1.0.0

package/dist/objects.d.ts

@@ -0,0 +1,146 @@
+// Type definitions
+type GetterDefObj = {
+    [key: PropertyKey]: () => unknown;
+};
+type LazyGetterStats = {
+    initialized?: Set<PropertyKey> | undefined;
+};
+type ConstantsObjectOptions = {
+    getters?: GetterDefObj | undefined;
+    internals?: object | undefined;
+    mixin?: object | undefined;
+};
+type Remap<T> = {
+    [K in keyof T]: T[K];
+} extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+// Type for generic property bag.
+type PropertyBag = {
+    [key: PropertyKey]: unknown;
+};
+// Type for generic sorted object entries.
+type SortedObject<T> = {
+    [key: PropertyKey]: T;
+};
+export type { GetterDefObj, LazyGetterStats, ConstantsObjectOptions, Remap };
+/**
+ * Create a lazy getter function that memoizes its result.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function createLazyGetter<T>(name: PropertyKey, getter: () => T, stats?: LazyGetterStats): () => T;
+/**
+ * Create a frozen constants object with lazy getters and internal properties.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function createConstantsObject(props: object, options_?: ConstantsObjectOptions): Readonly<object>;
+/**
+ * Define a getter property on an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function defineGetter<T>(object: object, propKey: PropertyKey, getter: () => T): object;
+/**
+ * Define a lazy getter property on an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function defineLazyGetter<T>(object: object, propKey: PropertyKey, getter: () => T, stats?: LazyGetterStats): object;
+/**
+ * Define multiple lazy getter properties on an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function defineLazyGetters(object: object, getterDefObj: GetterDefObj | undefined, stats?: LazyGetterStats): object;
+/**
+ * Compare two entry arrays by their keys for sorting.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function entryKeyComparator(a: [PropertyKey, unknown], b: [PropertyKey, unknown]): number;
+/**
+ * Get the enumerable own property keys of an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function getKeys(obj: unknown): string[];
+/**
+ * Get an own property value from an object safely.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function getOwn(obj: unknown, propKey: PropertyKey): unknown;
+/**
+ * Get all own property values from an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function getOwnPropertyValues<T>(obj: {
+    [key: PropertyKey]: T;
+} | null | undefined): T[];
+/**
+ * Check if an object has any enumerable own properties.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function hasKeys(obj: unknown): obj is PropertyBag;
+/**
+ * Check if an object has an own property.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function hasOwn(obj: unknown, propKey: PropertyKey): obj is object & PropertyBag;
+/**
+ * Check if a value is an object (including arrays).
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function isObject(value: unknown): value is {
+    [key: PropertyKey]: unknown;
+};
+/**
+ * Check if a value is a plain object (not an array, not a built-in).
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function isObjectObject(value: unknown): value is {
+    [key: PropertyKey]: unknown;
+};
+// IMPORTANT: Do not use destructuring here - use direct assignment instead.
+// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
+// `exports.SomeName = void 0;` which causes runtime errors.
+// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
+/**
+ * Alias for native Object.assign.
+ * Copies all enumerable own properties from one or more source objects to a target object.
+ */
+export declare const objectAssign: {
+    <T extends {}, U>(target: T, source: U): T & U;
+    <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
+    <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+    (target: object, ...sources: any[]): any;
+};
+/**
+ * Get all own property entries (key-value pairs) from an object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function objectEntries(obj: unknown): Array<[PropertyKey, unknown]>;
+// IMPORTANT: Do not use destructuring here - use direct assignment instead.
+// tsgo has a bug that incorrectly transpiles destructured exports, resulting in
+// `exports.SomeName = void 0;` which causes runtime errors.
+// See: https://github.com/SocketDev/socket-packageurl-js/issues/3
+/**
+ * Alias for native Object.freeze.
+ * Freezes an object, preventing new properties from being added and existing properties from being removed or modified.
+ */
+export declare const objectFreeze: {
+    <T extends Function>(f: T): T;
+    <T extends {
+        [idx: string]: object | U;
+    }, U extends string | number | bigint | symbol | boolean>(o: T): Readonly<T>;
+    <T>(o: T): Readonly<T>;
+};
+/**
+ * Deep merge source object into target object.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function merge<T extends object, U extends object>(target: T, source: U): T & U;
+/**
+ * Convert an object to a new object with sorted keys.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function toSortedObject<T extends object>(obj: T): T;
+/**
+ * Create an object from entries with sorted keys.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function toSortedObjectFromEntries<T = unknown>(entries: Iterable<[PropertyKey, T]>): SortedObject<T>;

package/dist/objects.js

@@ -0,0 +1,321 @@
+/* Socket Lib - Built with esbuild */
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var objects_exports = {};
+__export(objects_exports, {
+  createConstantsObject: () => createConstantsObject,
+  createLazyGetter: () => createLazyGetter,
+  defineGetter: () => defineGetter,
+  defineLazyGetter: () => defineLazyGetter,
+  defineLazyGetters: () => defineLazyGetters,
+  entryKeyComparator: () => entryKeyComparator,
+  getKeys: () => getKeys,
+  getOwn: () => getOwn,
+  getOwnPropertyValues: () => getOwnPropertyValues,
+  hasKeys: () => hasKeys,
+  hasOwn: () => hasOwn,
+  isObject: () => isObject,
+  isObjectObject: () => isObjectObject,
+  merge: () => merge,
+  objectAssign: () => objectAssign,
+  objectEntries: () => objectEntries,
+  objectFreeze: () => objectFreeze,
+  toSortedObject: () => toSortedObject,
+  toSortedObjectFromEntries: () => toSortedObjectFromEntries
+});
+module.exports = __toCommonJS(objects_exports);
+var import_core = require("#constants/core");
+var import_arrays = require("./arrays");
+var import_sorts = require("./sorts");
+const ObjectDefineProperties = Object.defineProperties;
+const ObjectDefineProperty = Object.defineProperty;
+const ObjectFreeze = Object.freeze;
+const ObjectFromEntries = Object.fromEntries;
+const ObjectGetOwnPropertyDescriptors = Object.getOwnPropertyDescriptors;
+const ObjectGetOwnPropertyNames = Object.getOwnPropertyNames;
+const ObjectGetPrototypeOf = Object.getPrototypeOf;
+const ObjectHasOwn = Object.hasOwn;
+const ObjectKeys = Object.keys;
+const ObjectPrototype = Object.prototype;
+const ObjectSetPrototypeOf = Object.setPrototypeOf;
+const __defineGetter__ = Object.prototype.__defineGetter__;
+const ReflectOwnKeys = Reflect.ownKeys;
+// @__NO_SIDE_EFFECTS__
+function createLazyGetter(name, getter, stats) {
+  let lazyValue = import_core.UNDEFINED_TOKEN;
+  const { [name]: lazyGetter } = {
+    [name]() {
+      if (lazyValue === import_core.UNDEFINED_TOKEN) {
+        stats?.initialized?.add(name);
+        lazyValue = getter();
+      }
+      return lazyValue;
+    }
+  };
+  return lazyGetter;
+}
+// @__NO_SIDE_EFFECTS__
+function createConstantsObject(props, options_) {
+  const options = { __proto__: null, ...options_ };
+  const attributes = ObjectFreeze({
+    __proto__: null,
+    getters: options.getters ? ObjectFreeze(
+      ObjectSetPrototypeOf(/* @__PURE__ */ toSortedObject(options.getters), null)
+    ) : void 0,
+    internals: options.internals ? ObjectFreeze(
+      ObjectSetPrototypeOf(/* @__PURE__ */ toSortedObject(options.internals), null)
+    ) : void 0,
+    mixin: options.mixin ? ObjectFreeze(
+      ObjectDefineProperties(
+        { __proto__: null },
+        ObjectGetOwnPropertyDescriptors(options.mixin)
+      )
+    ) : void 0,
+    props: props ? ObjectFreeze(ObjectSetPrototypeOf(/* @__PURE__ */ toSortedObject(props), null)) : void 0
+  });
+  const lazyGetterStats = ObjectFreeze({
+    __proto__: null,
+    initialized: /* @__PURE__ */ new Set()
+  });
+  const object = /* @__PURE__ */ defineLazyGetters(
+    {
+      __proto__: null,
+      [import_core.kInternalsSymbol]: ObjectFreeze({
+        __proto__: null,
+        get attributes() {
+          return attributes;
+        },
+        get lazyGetterStats() {
+          return lazyGetterStats;
+        },
+        ...attributes.internals
+      }),
+      kInternalsSymbol: import_core.kInternalsSymbol,
+      ...attributes.props
+    },
+    attributes.getters,
+    lazyGetterStats
+  );
+  if (attributes.mixin) {
+    ObjectDefineProperties(
+      object,
+      /* @__PURE__ */ toSortedObjectFromEntries(
+        (/* @__PURE__ */ objectEntries(ObjectGetOwnPropertyDescriptors(attributes.mixin))).filter(
+          (p) => !ObjectHasOwn(object, p[0])
+        )
+      )
+    );
+  }
+  return ObjectFreeze(object);
+}
+// @__NO_SIDE_EFFECTS__
+function defineGetter(object, propKey, getter) {
+  ObjectDefineProperty(object, propKey, {
+    get: getter,
+    enumerable: false,
+    configurable: true
+  });
+  return object;
+}
+// @__NO_SIDE_EFFECTS__
+function defineLazyGetter(object, propKey, getter, stats) {
+  return /* @__PURE__ */ defineGetter(object, propKey, /* @__PURE__ */ createLazyGetter(propKey, getter, stats));
+}
+// @__NO_SIDE_EFFECTS__
+function defineLazyGetters(object, getterDefObj, stats) {
+  if (getterDefObj !== null && typeof getterDefObj === "object") {
+    const keys = ReflectOwnKeys(getterDefObj);
+    for (let i = 0, { length } = keys; i < length; i += 1) {
+      const key = keys[i];
+      /* @__PURE__ */ defineLazyGetter(
+        object,
+        key,
+        /* @__PURE__ */ createLazyGetter(key, getterDefObj[key], stats)
+      );
+    }
+  }
+  return object;
+}
+// @__NO_SIDE_EFFECTS__
+function entryKeyComparator(a, b) {
+  const keyA = a[0];
+  const keyB = b[0];
+  const strKeyA = typeof keyA === "string" ? keyA : String(keyA);
+  const strKeyB = typeof keyB === "string" ? keyB : String(keyB);
+  return (0, import_sorts.localeCompare)(strKeyA, strKeyB);
+}
+// @__NO_SIDE_EFFECTS__
+function getKeys(obj) {
+  return /* @__PURE__ */ isObject(obj) ? ObjectKeys(obj) : [];
+}
+// @__NO_SIDE_EFFECTS__
+function getOwn(obj, propKey) {
+  if (obj === null || obj === void 0) {
+    return void 0;
+  }
+  return ObjectHasOwn(obj, propKey) ? obj[propKey] : void 0;
+}
+// @__NO_SIDE_EFFECTS__
+function getOwnPropertyValues(obj) {
+  if (obj === null || obj === void 0) {
+    return [];
+  }
+  const keys = ObjectGetOwnPropertyNames(obj);
+  const { length } = keys;
+  const values = Array(length);
+  for (let i = 0; i < length; i += 1) {
+    values[i] = obj[keys[i]];
+  }
+  return values;
+}
+// @__NO_SIDE_EFFECTS__
+function hasKeys(obj) {
+  if (obj === null || obj === void 0) {
+    return false;
+  }
+  for (const key in obj) {
+    if (ObjectHasOwn(obj, key)) {
+      return true;
+    }
+  }
+  return false;
+}
+// @__NO_SIDE_EFFECTS__
+function hasOwn(obj, propKey) {
+  if (obj === null || obj === void 0) {
+    return false;
+  }
+  return ObjectHasOwn(obj, propKey);
+}
+// @__NO_SIDE_EFFECTS__
+function isObject(value) {
+  return value !== null && typeof value === "object";
+}
+// @__NO_SIDE_EFFECTS__
+function isObjectObject(value) {
+  if (value === null || typeof value !== "object" || (0, import_arrays.isArray)(value)) {
+    return false;
+  }
+  const proto = ObjectGetPrototypeOf(value);
+  return proto === null || proto === ObjectPrototype;
+}
+const objectAssign = Object.assign;
+// @__NO_SIDE_EFFECTS__
+function objectEntries(obj) {
+  if (obj === null || obj === void 0) {
+    return [];
+  }
+  const keys = ReflectOwnKeys(obj);
+  const { length } = keys;
+  const entries = Array(length);
+  const record = obj;
+  for (let i = 0; i < length; i += 1) {
+    const key = keys[i];
+    entries[i] = [key, record[key]];
+  }
+  return entries;
+}
+const objectFreeze = Object.freeze;
+// @__NO_SIDE_EFFECTS__
+function merge(target, source) {
+  if (!/* @__PURE__ */ isObject(target) || !/* @__PURE__ */ isObject(source)) {
+    return target;
+  }
+  const queue = [[target, source]];
+  let pos = 0;
+  let { length: queueLength } = queue;
+  while (pos < queueLength) {
+    if (pos === import_core.LOOP_SENTINEL) {
+      throw new Error("Detected infinite loop in object crawl of merge");
+    }
+    const { 0: currentTarget, 1: currentSource } = queue[pos++];
+    if (!currentSource || !currentTarget) {
+      continue;
+    }
+    const isSourceArray = (0, import_arrays.isArray)(currentSource);
+    const isTargetArray = (0, import_arrays.isArray)(currentTarget);
+    if (isSourceArray || isTargetArray) {
+      continue;
+    }
+    const keys = ReflectOwnKeys(currentSource);
+    for (let i = 0, { length } = keys; i < length; i += 1) {
+      const key = keys[i];
+      const srcVal = currentSource[key];
+      const targetVal = currentTarget[key];
+      if ((0, import_arrays.isArray)(srcVal)) {
+        currentTarget[key] = srcVal;
+      } else if (/* @__PURE__ */ isObject(srcVal)) {
+        if (/* @__PURE__ */ isObject(targetVal) && !(0, import_arrays.isArray)(targetVal)) {
+          queue[queueLength++] = [targetVal, srcVal];
+        } else {
+          currentTarget[key] = srcVal;
+        }
+      } else {
+        currentTarget[key] = srcVal;
+      }
+    }
+  }
+  return target;
+}
+// @__NO_SIDE_EFFECTS__
+function toSortedObject(obj) {
+  return /* @__PURE__ */ toSortedObjectFromEntries(/* @__PURE__ */ objectEntries(obj));
+}
+// @__NO_SIDE_EFFECTS__
+function toSortedObjectFromEntries(entries) {
+  const otherEntries = [];
+  const symbolEntries = [];
+  for (const entry of entries) {
+    if (typeof entry[0] === "symbol") {
+      symbolEntries.push(entry);
+    } else {
+      otherEntries.push(entry);
+    }
+  }
+  if (!otherEntries.length && !symbolEntries.length) {
+    return {};
+  }
+  return ObjectFromEntries([
+    // The String constructor is safe to use with symbols.
+    ...symbolEntries.sort(entryKeyComparator),
+    ...otherEntries.sort(entryKeyComparator)
+  ]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createConstantsObject,
+  createLazyGetter,
+  defineGetter,
+  defineLazyGetter,
+  defineLazyGetters,
+  entryKeyComparator,
+  getKeys,
+  getOwn,
+  getOwnPropertyValues,
+  hasKeys,
+  hasOwn,
+  isObject,
+  isObjectObject,
+  merge,
+  objectAssign,
+  objectEntries,
+  objectFreeze,
+  toSortedObject,
+  toSortedObjectFromEntries
+});
+//# sourceMappingURL=objects.js.map

package/dist/objects.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/objects.ts"],
+  "sourcesContent": ["/**\n * @fileoverview Object manipulation and reflection utilities.\n * Provides type-safe object operations, property access, and structural helpers.\n */\n\nimport {\n  kInternalsSymbol,\n  LOOP_SENTINEL,\n  UNDEFINED_TOKEN,\n} from '#constants/core'\n\nimport { isArray } from './arrays'\nimport { localeCompare } from './sorts'\n\n// Type definitions\ntype GetterDefObj = { [key: PropertyKey]: () => unknown }\ntype LazyGetterStats = { initialized?: Set<PropertyKey> | undefined }\ntype ConstantsObjectOptions = {\n  getters?: GetterDefObj | undefined\n  internals?: object | undefined\n  mixin?: object | undefined\n}\ntype Remap<T> = { [K in keyof T]: T[K] } extends infer O\n  ? { [K in keyof O]: O[K] }\n  : never\n\n// Type for dynamic lazy getter record.\ntype LazyGetterRecord<T> = {\n  [key: PropertyKey]: () => T\n}\n\n// Type for generic property bag.\ntype PropertyBag = {\n  [key: PropertyKey]: unknown\n}\n\n// Type for generic sorted object entries.\ntype SortedObject<T> = {\n  [key: PropertyKey]: T\n}\n\nexport type { GetterDefObj, LazyGetterStats, ConstantsObjectOptions, Remap }\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ObjectDefineProperties = Object.defineProperties\nconst ObjectDefineProperty = Object.defineProperty\nconst ObjectFreeze = Object.freeze\nconst ObjectFromEntries = Object.fromEntries\nconst ObjectGetOwnPropertyDescriptors = Object.getOwnPropertyDescriptors\nconst ObjectGetOwnPropertyNames = Object.getOwnPropertyNames\nconst ObjectGetPrototypeOf = Object.getPrototypeOf\nconst ObjectHasOwn = Object.hasOwn\nconst ObjectKeys = Object.keys\nconst ObjectPrototype = Object.prototype\nconst ObjectSetPrototypeOf = Object.setPrototypeOf\n// @ts-expect-error - __defineGetter__ exists but not in type definitions.\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst __defineGetter__ = Object.prototype.__defineGetter__\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\nconst ReflectOwnKeys = Reflect.ownKeys\n\n/**\n * Create a lazy getter function that memoizes its result.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function createLazyGetter<T>(\n  name: PropertyKey,\n  getter: () => T,\n  stats?: LazyGetterStats,\n): () => T {\n  let lazyValue: T | typeof UNDEFINED_TOKEN = UNDEFINED_TOKEN\n  // Dynamically name the getter without using Object.defineProperty.\n  const { [name]: lazyGetter } = {\n    [name]() {\n      if (lazyValue === UNDEFINED_TOKEN) {\n        stats?.initialized?.add(name)\n        lazyValue = getter()\n      }\n      return lazyValue as T\n    },\n  } as LazyGetterRecord<T>\n  return lazyGetter as unknown as () => T\n}\n\n/**\n * Create a frozen constants object with lazy getters and internal properties.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function createConstantsObject(\n  props: object,\n  options_?: ConstantsObjectOptions,\n): Readonly<object> {\n  const options = { __proto__: null, ...options_ } as ConstantsObjectOptions\n  const attributes = ObjectFreeze({\n    __proto__: null,\n    getters: options.getters\n      ? ObjectFreeze(\n          ObjectSetPrototypeOf(toSortedObject(options.getters), null),\n        )\n      : undefined,\n    internals: options.internals\n      ? ObjectFreeze(\n          ObjectSetPrototypeOf(toSortedObject(options.internals), null),\n        )\n      : undefined,\n    mixin: options.mixin\n      ? ObjectFreeze(\n          ObjectDefineProperties(\n            { __proto__: null },\n            ObjectGetOwnPropertyDescriptors(options.mixin),\n          ),\n        )\n      : undefined,\n    props: props\n      ? ObjectFreeze(ObjectSetPrototypeOf(toSortedObject(props), null))\n      : undefined,\n  })\n  const lazyGetterStats = ObjectFreeze({\n    __proto__: null,\n    initialized: new Set<PropertyKey>(),\n  })\n  const object = defineLazyGetters(\n    {\n      __proto__: null,\n      [kInternalsSymbol]: ObjectFreeze({\n        __proto__: null,\n        get attributes() {\n          return attributes\n        },\n        get lazyGetterStats() {\n          return lazyGetterStats\n        },\n        ...attributes.internals,\n      }),\n      kInternalsSymbol,\n      ...attributes.props,\n    },\n    attributes.getters,\n    lazyGetterStats,\n  )\n  if (attributes.mixin) {\n    ObjectDefineProperties(\n      object,\n      toSortedObjectFromEntries(\n        objectEntries(ObjectGetOwnPropertyDescriptors(attributes.mixin)).filter(\n          p => !ObjectHasOwn(object, p[0]),\n        ),\n      ) as PropertyDescriptorMap,\n    )\n  }\n  return ObjectFreeze(object)\n}\n\n/**\n * Define a getter property on an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function defineGetter<T>(\n  object: object,\n  propKey: PropertyKey,\n  getter: () => T,\n): object {\n  ObjectDefineProperty(object, propKey, {\n    get: getter,\n    enumerable: false,\n    configurable: true,\n  })\n  return object\n}\n\n/**\n * Define a lazy getter property on an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function defineLazyGetter<T>(\n  object: object,\n  propKey: PropertyKey,\n  getter: () => T,\n  stats?: LazyGetterStats,\n): object {\n  return defineGetter(object, propKey, createLazyGetter(propKey, getter, stats))\n}\n\n/**\n * Define multiple lazy getter properties on an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function defineLazyGetters(\n  object: object,\n  getterDefObj: GetterDefObj | undefined,\n  stats?: LazyGetterStats,\n): object {\n  if (getterDefObj !== null && typeof getterDefObj === 'object') {\n    const keys = ReflectOwnKeys(getterDefObj)\n    for (let i = 0, { length } = keys; i < length; i += 1) {\n      const key = keys[i] as PropertyKey\n      defineLazyGetter(\n        object,\n        key,\n        createLazyGetter(key, getterDefObj[key] as () => unknown, stats),\n      )\n    }\n  }\n  return object\n}\n\n/**\n * Compare two entry arrays by their keys for sorting.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function entryKeyComparator(\n  a: [PropertyKey, unknown],\n  b: [PropertyKey, unknown],\n): number {\n  const keyA = a[0]\n  const keyB = b[0]\n  const strKeyA = typeof keyA === 'string' ? keyA : String(keyA)\n  const strKeyB = typeof keyB === 'string' ? keyB : String(keyB)\n  return localeCompare(strKeyA, strKeyB)\n}\n\n/**\n * Get the enumerable own property keys of an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getKeys(obj: unknown): string[] {\n  return isObject(obj) ? ObjectKeys(obj) : []\n}\n\n/**\n * Get an own property value from an object safely.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getOwn(obj: unknown, propKey: PropertyKey): unknown {\n  if (obj === null || obj === undefined) {\n    return undefined\n  }\n  return ObjectHasOwn(obj as object, propKey)\n    ? (obj as Record<PropertyKey, unknown>)[propKey]\n    : undefined\n}\n\n/**\n * Get all own property values from an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function getOwnPropertyValues<T>(\n  obj: { [key: PropertyKey]: T } | null | undefined,\n): T[] {\n  if (obj === null || obj === undefined) {\n    return []\n  }\n  const keys = ObjectGetOwnPropertyNames(obj)\n  const { length } = keys\n  const values = Array(length)\n  for (let i = 0; i < length; i += 1) {\n    values[i] = obj[keys[i] as string]\n  }\n  return values\n}\n\n/**\n * Check if an object has any enumerable own properties.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function hasKeys(obj: unknown): obj is PropertyBag {\n  if (obj === null || obj === undefined) {\n    return false\n  }\n  for (const key in obj as object) {\n    if (ObjectHasOwn(obj as object, key)) {\n      return true\n    }\n  }\n  return false\n}\n\n/**\n * Check if an object has an own property.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function hasOwn(\n  obj: unknown,\n  propKey: PropertyKey,\n): obj is object & PropertyBag {\n  if (obj === null || obj === undefined) {\n    return false\n  }\n  return ObjectHasOwn(obj as object, propKey)\n}\n\n/**\n * Check if a value is an object (including arrays).\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isObject(\n  value: unknown,\n): value is { [key: PropertyKey]: unknown } {\n  return value !== null && typeof value === 'object'\n}\n\n/**\n * Check if a value is a plain object (not an array, not a built-in).\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function isObjectObject(\n  value: unknown,\n): value is { [key: PropertyKey]: unknown } {\n  if (value === null || typeof value !== 'object' || isArray(value)) {\n    return false\n  }\n  const proto = ObjectGetPrototypeOf(value)\n  return proto === null || proto === ObjectPrototype\n}\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\n\n/**\n * Alias for native Object.assign.\n * Copies all enumerable own properties from one or more source objects to a target object.\n */\nexport const objectAssign = Object.assign\n\n/**\n * Get all own property entries (key-value pairs) from an object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function objectEntries(obj: unknown): Array<[PropertyKey, unknown]> {\n  if (obj === null || obj === undefined) {\n    return []\n  }\n  const keys = ReflectOwnKeys(obj as object)\n  const { length } = keys\n  const entries = Array(length)\n  const record = obj as Record<PropertyKey, unknown>\n  for (let i = 0; i < length; i += 1) {\n    const key = keys[i] as PropertyKey\n    entries[i] = [key, record[key]]\n  }\n  return entries\n}\n\n// IMPORTANT: Do not use destructuring here - use direct assignment instead.\n// tsgo has a bug that incorrectly transpiles destructured exports, resulting in\n// `exports.SomeName = void 0;` which causes runtime errors.\n// See: https://github.com/SocketDev/socket-packageurl-js/issues/3\n\n/**\n * Alias for native Object.freeze.\n * Freezes an object, preventing new properties from being added and existing properties from being removed or modified.\n */\nexport const objectFreeze = Object.freeze\n\n/**\n * Deep merge source object into target object.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function merge<T extends object, U extends object>(\n  target: T,\n  source: U,\n): T & U {\n  if (!isObject(target) || !isObject(source)) {\n    return target as T & U\n  }\n  const queue: Array<[unknown, unknown]> = [[target, source]]\n  let pos = 0\n  let { length: queueLength } = queue\n  while (pos < queueLength) {\n    if (pos === LOOP_SENTINEL) {\n      throw new Error('Detected infinite loop in object crawl of merge')\n    }\n    const { 0: currentTarget, 1: currentSource } = queue[pos++] as [\n      Record<PropertyKey, unknown>,\n      Record<PropertyKey, unknown>,\n    ]\n\n    if (!currentSource || !currentTarget) {\n      continue\n    }\n\n    const isSourceArray = isArray(currentSource)\n    const isTargetArray = isArray(currentTarget)\n\n    // Skip array merging - arrays in source replace arrays in target\n    if (isSourceArray || isTargetArray) {\n      continue\n    }\n\n    const keys = ReflectOwnKeys(currentSource as object)\n    for (let i = 0, { length } = keys; i < length; i += 1) {\n      const key = keys[i] as PropertyKey\n      const srcVal = currentSource[key]\n      const targetVal = currentTarget[key]\n      if (isArray(srcVal)) {\n        // Replace arrays entirely\n        currentTarget[key] = srcVal\n      } else if (isObject(srcVal)) {\n        if (isObject(targetVal) && !isArray(targetVal)) {\n          queue[queueLength++] = [targetVal, srcVal]\n        } else {\n          currentTarget[key] = srcVal\n        }\n      } else {\n        currentTarget[key] = srcVal\n      }\n    }\n  }\n  return target as T & U\n}\n\n/**\n * Convert an object to a new object with sorted keys.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function toSortedObject<T extends object>(obj: T): T {\n  return toSortedObjectFromEntries(objectEntries(obj)) as T\n}\n\n/**\n * Create an object from entries with sorted keys.\n */\n/*@__NO_SIDE_EFFECTS__*/\nexport function toSortedObjectFromEntries<T = unknown>(\n  entries: Iterable<[PropertyKey, T]>,\n): SortedObject<T> {\n  const otherEntries = []\n  const symbolEntries = []\n  // Use for-of to work with entries iterators.\n  for (const entry of entries) {\n    if (typeof entry[0] === 'symbol') {\n      symbolEntries.push(entry)\n    } else {\n      otherEntries.push(entry)\n    }\n  }\n  if (!otherEntries.length && !symbolEntries.length) {\n    return {}\n  }\n  return ObjectFromEntries([\n    // The String constructor is safe to use with symbols.\n    ...symbolEntries.sort(entryKeyComparator),\n    ...otherEntries.sort(entryKeyComparator),\n  ])\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/packages/editable.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Editable package.json manipulation utilities.
+ */
+import type { EditablePackageJsonOptions, NormalizeOptions, PackageJson, SaveOptions } from '../packages';
+// Define the interface for the dynamic class
+interface EditablePackageJsonConstructor {
+    new (): EditablePackageJsonInstance;
+    fixSteps: unknown[];
+    normalizeSteps: unknown[];
+    prepareSteps: unknown[];
+    create(path: string, opts?: EditablePackageJsonOptions): Promise<EditablePackageJsonInstance>;
+    fix(path: string, opts?: unknown): Promise<EditablePackageJsonInstance>;
+    load(path: string, opts?: EditablePackageJsonOptions): Promise<EditablePackageJsonInstance>;
+    normalize(path: string, opts?: NormalizeOptions): Promise<EditablePackageJsonInstance>;
+    prepare(path: string, opts?: unknown): Promise<EditablePackageJsonInstance>;
+}
+/**
+ * EditablePackageJson instance interface extending NPMCliPackageJson functionality.
+ * Provides enhanced package.json manipulation with Socket-specific features.
+ * @extends NPMCliPackageJson (from @npmcli/package-json)
+ */
+export interface EditablePackageJsonInstance {
+    /**
+     * The parsed package.json content as a readonly object.
+     * @readonly
+     */
+    content: Readonly<PackageJson>;
+    /**
+     * Create a new package.json file at the specified path.
+     * @param path - The directory path where package.json will be created
+     */
+    create(path: string): this;
+    /**
+     * Apply automatic fixes to the package.json based on npm standards.
+     * @param opts - Optional fix configuration
+     */
+    fix(opts?: unknown | undefined): Promise<this>;
+    /**
+     * Initialize the instance from a content object.
+     * @param content - The package.json content object
+     */
+    fromContent(content: unknown): this;
+    /**
+     * Initialize the instance from a JSON string.
+     * @param json - The package.json content as a JSON string
+     */
+    fromJSON(json: string): this;
+    /**
+     * Load a package.json file from the specified path.
+     * @param path - The directory containing the package.json
+     * @param create - Whether to create the file if it doesn't exist
+     */
+    load(path: string, create?: boolean): Promise<this>;
+    /**
+     * Normalize the package.json content according to npm standards.
+     * @param opts - Normalization options
+     */
+    normalize(opts?: NormalizeOptions): Promise<this>;
+    /**
+     * Prepare the package.json for publishing.
+     * @param opts - Preparation options
+     */
+    prepare(opts?: unknown): Promise<this>;
+    /**
+     * Update the package.json content with new values.
+     * @param content - Partial package.json object with fields to update
+     * @override from NPMCliPackageJson
+     */
+    update(content: Partial<PackageJson>): this;
+    /**
+     * Save the package.json file to disk.
+     * @param options - Save options for formatting and sorting
+     * @override from NPMCliPackageJson
+     */
+    save(options?: SaveOptions | undefined): Promise<boolean>;
+    /**
+     * Synchronously save the package.json file to disk.
+     * @param options - Save options for formatting and sorting
+     */
+    saveSync(options?: SaveOptions | undefined): boolean;
+    /**
+     * Check if the package.json will be saved based on current changes.
+     * @param options - Save options to evaluate
+     */
+    willSave(options?: SaveOptions | undefined): boolean;
+}
+/**
+ * Get the EditablePackageJson class for package.json manipulation.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function getEditablePackageJsonClass(): EditablePackageJsonConstructor;
+/**
+ * Convert a package.json object to an editable instance.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function pkgJsonToEditable(pkgJson: PackageJson, options?: EditablePackageJsonOptions): unknown;
+/**
+ * Convert package.json to editable instance with file persistence.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function toEditablePackageJson(pkgJson: PackageJson, options?: EditablePackageJsonOptions): Promise<unknown>;
+/**
+ * Convert package.json to editable instance with file persistence synchronously.
+ */
+/*@__NO_SIDE_EFFECTS__*/
+export declare function toEditablePackageJsonSync(pkgJson: PackageJson, options?: EditablePackageJsonOptions): unknown;
+export {};