immutable-builtins 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Francesco Salvi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# Immutable Built-ins
+
+Dependency-free collection of immutable replacements for JavaScript builtins
+
+## Installation
+
+```bash
+yarn add immutable-builtins
+```
+
+## Example Usage
+
+```typescript
+import { ImmutableDate } from 'immutable-builtins';
+
+const d1 = new ImmutableDate();
+const d2 = new ImmutableDate(d1.toMutable().setFullYear(0));
+
+// TypeScript error: "Property 'setFullYear' does not exist on type 'ImmutableDate'";
+// Runtime/JavaScript error: "Cannot use a mutating method on an ImmutableDate instance"
+d1.setFullYear(0);
+```
+
+## Contributing
+
+Issues and PRs welcome!
+
+## License
+
+MIT

package/dist/cjs/ImmutableDate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * This is the *instance* type
+ */
+export type ImmutableDate = Omit<Date, 'setTime' | 'setMilliseconds' | 'setUTCMilliseconds' | 'setSeconds' | 'setUTCSeconds' | 'setMinutes' | 'setUTCMinutes' | 'setHours' | 'setUTCHours' | 'setDate' | 'setUTCDate' | 'setMonth' | 'setUTCMonth' | 'setFullYear' | 'setUTCFullYear' | 'setYear'> & {
+    readonly __ImmutableDate__brand: undefined;
+    /**
+     * Creates a new regular (mutable) date by cloning the current instance
+     */
+    toMutable(): Date;
+};
+/**
+ * Notes for users:
+ *
+ * A derived `Date` definition where all the mutating methods have been disabled
+ *    both at compile-time (TS) and runtime (JS).
+ *  To obtain (cast to) a regular `Date` from it, use the `toMutable` extension method.
+ *  Constructor signatures support is identical to that of `Date`, with the added
+ *   benefit that it automatically throws in case an `Invalid Date` is yielded internally.
+ *
+ * ---
+ * Notes for maintainers:
+ *
+ * This is the class/constructor definition
+ * - we implement a class that extends Date
+ * - we forbid invocation of methods that mutate the internal date value (runtime guards)
+ * - we assign the new class (constructor) to a constant that we type as
+ *    a modified DateConstructor that instead of returning Date returns our
+ *    "trimmed" version without setters (plus the additional `toMutable` utility).
+ */
+export declare const ImmutableDate: {
+    readonly prototype: ImmutableDate;
+    new (): ImmutableDate;
+    new (value: number | string | Date | ImmutableDate): ImmutableDate;
+    new (year: number, monthIndex: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): ImmutableDate;
+    /** @see Date.parse */
+    parse(s: string): number;
+    /** @see Date.UTC */
+    UTC(...args: Parameters<DateConstructor['UTC']>): number;
+    /** @see Date.now */
+    now(): number;
+};

package/dist/cjs/ImmutableDate.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImmutableDate = void 0;
+/**
+ * Notes for users:
+ *
+ * A derived `Date` definition where all the mutating methods have been disabled
+ *    both at compile-time (TS) and runtime (JS).
+ *  To obtain (cast to) a regular `Date` from it, use the `toMutable` extension method.
+ *  Constructor signatures support is identical to that of `Date`, with the added
+ *   benefit that it automatically throws in case an `Invalid Date` is yielded internally.
+ *
+ * ---
+ * Notes for maintainers:
+ *
+ * This is the class/constructor definition
+ * - we implement a class that extends Date
+ * - we forbid invocation of methods that mutate the internal date value (runtime guards)
+ * - we assign the new class (constructor) to a constant that we type as
+ *    a modified DateConstructor that instead of returning Date returns our
+ *    "trimmed" version without setters (plus the additional `toMutable` utility).
+ */
+const ImmutableDate = class extends Date {
+    __ImmutableDate__brand;
+    setTime = throwCannotUseMutatingMethodError;
+    setMilliseconds = throwCannotUseMutatingMethodError;
+    setUTCMilliseconds = throwCannotUseMutatingMethodError;
+    setSeconds = throwCannotUseMutatingMethodError;
+    setUTCSeconds = throwCannotUseMutatingMethodError;
+    setMinutes = throwCannotUseMutatingMethodError;
+    setUTCMinutes = throwCannotUseMutatingMethodError;
+    setHours = throwCannotUseMutatingMethodError;
+    setUTCHours = throwCannotUseMutatingMethodError;
+    setDate = throwCannotUseMutatingMethodError;
+    setUTCDate = throwCannotUseMutatingMethodError;
+    setMonth = throwCannotUseMutatingMethodError;
+    setUTCMonth = throwCannotUseMutatingMethodError;
+    setFullYear = throwCannotUseMutatingMethodError;
+    setUTCFullYear = throwCannotUseMutatingMethodError;
+    /* override */ setYear = throwCannotUseMutatingMethodError; // not included in default lib
+    // as an added QoL improvement, let's also enforce the construction of valid dates
+    constructor(...args) {
+        // @ts-expect-error[TS2556]: A spread argument must either have a tuple type or be passed to a rest parameter.
+        super(...args);
+        if (isNaN(this.valueOf())) {
+            throw new Error('Could not construct a valid date');
+        }
+    }
+    toMutable() {
+        return new Date(this.valueOf());
+    }
+};
+exports.ImmutableDate = ImmutableDate;
+function throwCannotUseMutatingMethodError() {
+    throw new Error('Cannot use a mutating method on an ImmutableDate instance');
+}
+;
+//# sourceMappingURL=ImmutableDate.js.map

package/dist/cjs/ImmutableDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableDate.js","sourceRoot":"","sources":["../../src/ImmutableDate.ts"],"names":[],"mappings":";;;AA6BA;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,aAAa,GAgBtB,KAAM,SAAQ,IAAI;IACX,sBAAsB,CAAY;IAElC,OAAO,GAAiB,iCAAiC,CAAC;IAC1D,eAAe,GAAiB,iCAAiC,CAAC;IAClE,kBAAkB,GAAiB,iCAAiC,CAAC;IACrE,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,aAAa,GAAiB,iCAAiC,CAAC;IAChE,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,aAAa,GAAiB,iCAAiC,CAAC;IAChE,QAAQ,GAAiB,iCAAiC,CAAC;IAC3D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,OAAO,GAAiB,iCAAiC,CAAC;IAC1D,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,QAAQ,GAAiB,iCAAiC,CAAC;IAC3D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,cAAc,GAAiB,iCAAiC,CAAC;IAC1E,cAAc,CAAC,OAAO,GAAiB,iCAAiC,CAAC,CAAC,8BAA8B;IAExG,kFAAkF;IAClF,YAAY,GAAG,IAAe;QAC5B,8GAA8G;QAC9G,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEf,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;CACF,CAAC;AAjDW,QAAA,aAAa,iBAiDxB;AAEF,SAAS,iCAAiC;IACxC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC/E,CAAC;AAAA,CAAC"}

package/dist/cjs/ImmutableURL.d.ts

@@ -0,0 +1,22 @@
+import { ImmutableURLSearchParamsUnbranded } from './ImmutableURLSearchParams';
+/**
+ * This is the *instance* type
+ */
+export type ImmutableURL = {
+    readonly [K in keyof URL]: K extends 'searchParams' ? ImmutableURLSearchParamsUnbranded : URL[K];
+} & {
+    readonly __ImmutableURL__brand: undefined;
+};
+/**
+ * This is the class/constructor definition
+ */
+export declare const ImmutableURL: {
+    readonly prototype: ImmutableURL;
+    new (url: string | URL | ImmutableURL, base?: string | URL | ImmutableURL): ImmutableURL;
+    /** @see {URL.canParse} */
+    canParse(url: string | URL, base?: string): boolean;
+    /** @see {URL.createObjectURL} */
+    createObjectURL(obj: Blob): string;
+    /** @see {URL.revokeObjectURL} */
+    revokeObjectURL(url: string): void;
+};

package/dist/cjs/ImmutableURL.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImmutableURL = void 0;
+const ImmutableURLSearchParams_1 = require("./ImmutableURLSearchParams");
+/**
+ * This is the class/constructor definition
+ */
+const ImmutableURL = class extends URL {
+    __ImmutableURL__brand;
+    constructor(...args) {
+        // @ts-expect-error[TS2556]: A spread argument must either have a tuple type or be passed to a rest parameter.
+        super(...args);
+        const makePropImmutable = (propName) => {
+            const propValue = this[propName];
+            Object.defineProperties(this, {
+                [propName]: {
+                    configurable: false,
+                    get: () => propValue,
+                    set: () => {
+                        throw new Error('Cannot use property setter on an ImmutableURL instance');
+                    }
+                }
+            });
+        };
+        makePropImmutable('hash');
+        makePropImmutable('host');
+        makePropImmutable('hostname');
+        makePropImmutable('href');
+        makePropImmutable('origin');
+        makePropImmutable('password');
+        makePropImmutable('pathname');
+        makePropImmutable('port');
+        makePropImmutable('protocol');
+        makePropImmutable('search');
+        makePropImmutable('username');
+        const searchParams = this.searchParams;
+        Object.defineProperties(this, {
+            searchParams: {
+                configurable: false,
+                get: () => new ImmutableURLSearchParams_1.ImmutableURLSearchParams(searchParams),
+                set: () => {
+                    throw new Error('Cannot use property setter on an ImmutableURL instance');
+                }
+            },
+        });
+    }
+};
+exports.ImmutableURL = ImmutableURL;
+//# sourceMappingURL=ImmutableURL.js.map

package/dist/cjs/ImmutableURL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableURL.js","sourceRoot":"","sources":["../../src/ImmutableURL.ts"],"names":[],"mappings":";;;AAAA,yEAAyG;AAazG;;GAEG;AACI,MAAM,YAAY,GAWrB,KAAM,SAAQ,GAAG;IACV,qBAAqB,CAAY;IAE1C,YAAY,GAAG,IAAe;QAC5B,8GAA8G;QAC9G,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEf,MAAM,iBAAiB,GAAG,CAAC,QAAmB,EAAQ,EAAE;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBAC5B,CAAC,QAAQ,CAAC,EAAE;oBACV,YAAY,EAAE,KAAK;oBACnB,GAAG,EAAE,GAAqB,EAAE,CAAC,SAAS;oBACtC,GAAG,EAAE,GAAW,EAAE;wBAChB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;oBAC5E,CAAC;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAE9B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAEvC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC5B,YAAY,EAAE;gBACZ,YAAY,EAAE,KAAK;gBACnB,GAAG,EAAE,GAA6B,EAAE,CAAC,IAAI,mDAAwB,CAAC,YAAY,CAAC;gBAC/E,GAAG,EAAE,GAAW,EAAE;oBAChB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBAC5E,CAAC;aACD;SACH,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAxDW,QAAA,YAAY,gBAwDvB"}

package/dist/cjs/ImmutableURLSearchParams.d.ts

@@ -0,0 +1,14 @@
+export type ImmutableURLSearchParamsUnbranded = Readonly<Omit<URLSearchParams, 'append' | 'delete' | 'set' | 'sort'>>;
+/**
+ * This is the *instance* type
+ */
+export type ImmutableURLSearchParams = ImmutableURLSearchParamsUnbranded & {
+    readonly __ImmutableURLSearchParams__brand: undefined;
+};
+/**
+ * This is the class/constructor definition
+ */
+export declare const ImmutableURLSearchParams: {
+    readonly prototype: ImmutableURLSearchParams;
+    new (init?: string[][] | Record<string, string> | string | URLSearchParams | ImmutableURLSearchParams): ImmutableURLSearchParams;
+};

package/dist/cjs/ImmutableURLSearchParams.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImmutableURLSearchParams = void 0;
+/**
+ * This is the class/constructor definition
+ */
+const ImmutableURLSearchParams = class extends URLSearchParams {
+    __ImmutableURLSearchParams__brand;
+    append = throwCannotUseMutatingMethodError;
+    delete = throwCannotUseMutatingMethodError;
+    set = throwCannotUseMutatingMethodError;
+    sort = throwCannotUseMutatingMethodError;
+    // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+    constructor(...args) {
+        // @ts-expect-error[TS2345]: Argument of type unknown is not assignable to parameter of type...
+        super(...args);
+    }
+};
+exports.ImmutableURLSearchParams = ImmutableURLSearchParams;
+function throwCannotUseMutatingMethodError() {
+    throw new Error('Cannot use a mutating method on an ImmutableURLSearchParams instance');
+}
+;
+//# sourceMappingURL=ImmutableURLSearchParams.js.map

package/dist/cjs/ImmutableURLSearchParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableURLSearchParams.js","sourceRoot":"","sources":["../../src/ImmutableURLSearchParams.ts"],"names":[],"mappings":";;;AAcA;;GAEG;AACI,MAAM,wBAAwB,GAIjC,KAAM,SAAQ,eAAe;IACtB,iCAAiC,CAAY;IAE7C,MAAM,GAAe,iCAAiC,CAAC;IACvD,MAAM,GAAe,iCAAiC,CAAC;IACvD,GAAG,GAAe,iCAAiC,CAAC;IACpD,IAAI,GAAe,iCAAiC,CAAC;IAE9D,qEAAqE;IACrE,YAAY,GAAG,IAAe;QAC5B,+FAA+F;QAC/F,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACjB,CAAC;CACF,CAAC;AAjBW,QAAA,wBAAwB,4BAiBnC;AAEF,SAAS,iCAAiC;IACxC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAAA,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export { ImmutableDate } from './ImmutableDate';
+export { ImmutableURL } from './ImmutableURL';
+export { ImmutableURLSearchParams } from './ImmutableURLSearchParams';

package/dist/cjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImmutableURLSearchParams = exports.ImmutableURL = exports.ImmutableDate = void 0;
+var ImmutableDate_1 = require("./ImmutableDate");
+Object.defineProperty(exports, "ImmutableDate", { enumerable: true, get: function () { return ImmutableDate_1.ImmutableDate; } });
+var ImmutableURL_1 = require("./ImmutableURL");
+Object.defineProperty(exports, "ImmutableURL", { enumerable: true, get: function () { return ImmutableURL_1.ImmutableURL; } });
+var ImmutableURLSearchParams_1 = require("./ImmutableURLSearchParams");
+Object.defineProperty(exports, "ImmutableURLSearchParams", { enumerable: true, get: function () { return ImmutableURLSearchParams_1.ImmutableURLSearchParams; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/esm/ImmutableDate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * This is the *instance* type
+ */
+export type ImmutableDate = Omit<Date, 'setTime' | 'setMilliseconds' | 'setUTCMilliseconds' | 'setSeconds' | 'setUTCSeconds' | 'setMinutes' | 'setUTCMinutes' | 'setHours' | 'setUTCHours' | 'setDate' | 'setUTCDate' | 'setMonth' | 'setUTCMonth' | 'setFullYear' | 'setUTCFullYear' | 'setYear'> & {
+    readonly __ImmutableDate__brand: undefined;
+    /**
+     * Creates a new regular (mutable) date by cloning the current instance
+     */
+    toMutable(): Date;
+};
+/**
+ * Notes for users:
+ *
+ * A derived `Date` definition where all the mutating methods have been disabled
+ *    both at compile-time (TS) and runtime (JS).
+ *  To obtain (cast to) a regular `Date` from it, use the `toMutable` extension method.
+ *  Constructor signatures support is identical to that of `Date`, with the added
+ *   benefit that it automatically throws in case an `Invalid Date` is yielded internally.
+ *
+ * ---
+ * Notes for maintainers:
+ *
+ * This is the class/constructor definition
+ * - we implement a class that extends Date
+ * - we forbid invocation of methods that mutate the internal date value (runtime guards)
+ * - we assign the new class (constructor) to a constant that we type as
+ *    a modified DateConstructor that instead of returning Date returns our
+ *    "trimmed" version without setters (plus the additional `toMutable` utility).
+ */
+export declare const ImmutableDate: {
+    readonly prototype: ImmutableDate;
+    new (): ImmutableDate;
+    new (value: number | string | Date | ImmutableDate): ImmutableDate;
+    new (year: number, monthIndex: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): ImmutableDate;
+    /** @see Date.parse */
+    parse(s: string): number;
+    /** @see Date.UTC */
+    UTC(...args: Parameters<DateConstructor['UTC']>): number;
+    /** @see Date.now */
+    now(): number;
+};

package/dist/esm/ImmutableDate.js

@@ -0,0 +1,54 @@
+/**
+ * Notes for users:
+ *
+ * A derived `Date` definition where all the mutating methods have been disabled
+ *    both at compile-time (TS) and runtime (JS).
+ *  To obtain (cast to) a regular `Date` from it, use the `toMutable` extension method.
+ *  Constructor signatures support is identical to that of `Date`, with the added
+ *   benefit that it automatically throws in case an `Invalid Date` is yielded internally.
+ *
+ * ---
+ * Notes for maintainers:
+ *
+ * This is the class/constructor definition
+ * - we implement a class that extends Date
+ * - we forbid invocation of methods that mutate the internal date value (runtime guards)
+ * - we assign the new class (constructor) to a constant that we type as
+ *    a modified DateConstructor that instead of returning Date returns our
+ *    "trimmed" version without setters (plus the additional `toMutable` utility).
+ */
+export const ImmutableDate = class extends Date {
+    __ImmutableDate__brand;
+    setTime = throwCannotUseMutatingMethodError;
+    setMilliseconds = throwCannotUseMutatingMethodError;
+    setUTCMilliseconds = throwCannotUseMutatingMethodError;
+    setSeconds = throwCannotUseMutatingMethodError;
+    setUTCSeconds = throwCannotUseMutatingMethodError;
+    setMinutes = throwCannotUseMutatingMethodError;
+    setUTCMinutes = throwCannotUseMutatingMethodError;
+    setHours = throwCannotUseMutatingMethodError;
+    setUTCHours = throwCannotUseMutatingMethodError;
+    setDate = throwCannotUseMutatingMethodError;
+    setUTCDate = throwCannotUseMutatingMethodError;
+    setMonth = throwCannotUseMutatingMethodError;
+    setUTCMonth = throwCannotUseMutatingMethodError;
+    setFullYear = throwCannotUseMutatingMethodError;
+    setUTCFullYear = throwCannotUseMutatingMethodError;
+    /* override */ setYear = throwCannotUseMutatingMethodError; // not included in default lib
+    // as an added QoL improvement, let's also enforce the construction of valid dates
+    constructor(...args) {
+        // @ts-expect-error[TS2556]: A spread argument must either have a tuple type or be passed to a rest parameter.
+        super(...args);
+        if (isNaN(this.valueOf())) {
+            throw new Error('Could not construct a valid date');
+        }
+    }
+    toMutable() {
+        return new Date(this.valueOf());
+    }
+};
+function throwCannotUseMutatingMethodError() {
+    throw new Error('Cannot use a mutating method on an ImmutableDate instance');
+}
+;
+//# sourceMappingURL=ImmutableDate.js.map

package/dist/esm/ImmutableDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableDate.js","sourceRoot":"","sources":["../../src/ImmutableDate.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,aAAa,GAgBtB,KAAM,SAAQ,IAAI;IACX,sBAAsB,CAAY;IAElC,OAAO,GAAiB,iCAAiC,CAAC;IAC1D,eAAe,GAAiB,iCAAiC,CAAC;IAClE,kBAAkB,GAAiB,iCAAiC,CAAC;IACrE,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,aAAa,GAAiB,iCAAiC,CAAC;IAChE,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,aAAa,GAAiB,iCAAiC,CAAC;IAChE,QAAQ,GAAiB,iCAAiC,CAAC;IAC3D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,OAAO,GAAiB,iCAAiC,CAAC;IAC1D,UAAU,GAAiB,iCAAiC,CAAC;IAC7D,QAAQ,GAAiB,iCAAiC,CAAC;IAC3D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,WAAW,GAAiB,iCAAiC,CAAC;IAC9D,cAAc,GAAiB,iCAAiC,CAAC;IAC1E,cAAc,CAAC,OAAO,GAAiB,iCAAiC,CAAC,CAAC,8BAA8B;IAExG,kFAAkF;IAClF,YAAY,GAAG,IAAe;QAC5B,8GAA8G;QAC9G,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEf,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClC,CAAC;CACF,CAAC;AAEF,SAAS,iCAAiC;IACxC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC/E,CAAC;AAAA,CAAC"}

package/dist/esm/ImmutableURL.d.ts

@@ -0,0 +1,22 @@
+import { ImmutableURLSearchParamsUnbranded } from './ImmutableURLSearchParams.js';
+/**
+ * This is the *instance* type
+ */
+export type ImmutableURL = {
+    readonly [K in keyof URL]: K extends 'searchParams' ? ImmutableURLSearchParamsUnbranded : URL[K];
+} & {
+    readonly __ImmutableURL__brand: undefined;
+};
+/**
+ * This is the class/constructor definition
+ */
+export declare const ImmutableURL: {
+    readonly prototype: ImmutableURL;
+    new (url: string | URL | ImmutableURL, base?: string | URL | ImmutableURL): ImmutableURL;
+    /** @see {URL.canParse} */
+    canParse(url: string | URL, base?: string): boolean;
+    /** @see {URL.createObjectURL} */
+    createObjectURL(obj: Blob): string;
+    /** @see {URL.revokeObjectURL} */
+    revokeObjectURL(url: string): void;
+};

package/dist/esm/ImmutableURL.js

@@ -0,0 +1,45 @@
+import { ImmutableURLSearchParams } from './ImmutableURLSearchParams.js';
+/**
+ * This is the class/constructor definition
+ */
+export const ImmutableURL = class extends URL {
+    __ImmutableURL__brand;
+    constructor(...args) {
+        // @ts-expect-error[TS2556]: A spread argument must either have a tuple type or be passed to a rest parameter.
+        super(...args);
+        const makePropImmutable = (propName) => {
+            const propValue = this[propName];
+            Object.defineProperties(this, {
+                [propName]: {
+                    configurable: false,
+                    get: () => propValue,
+                    set: () => {
+                        throw new Error('Cannot use property setter on an ImmutableURL instance');
+                    }
+                }
+            });
+        };
+        makePropImmutable('hash');
+        makePropImmutable('host');
+        makePropImmutable('hostname');
+        makePropImmutable('href');
+        makePropImmutable('origin');
+        makePropImmutable('password');
+        makePropImmutable('pathname');
+        makePropImmutable('port');
+        makePropImmutable('protocol');
+        makePropImmutable('search');
+        makePropImmutable('username');
+        const searchParams = this.searchParams;
+        Object.defineProperties(this, {
+            searchParams: {
+                configurable: false,
+                get: () => new ImmutableURLSearchParams(searchParams),
+                set: () => {
+                    throw new Error('Cannot use property setter on an ImmutableURL instance');
+                }
+            },
+        });
+    }
+};
+//# sourceMappingURL=ImmutableURL.js.map

package/dist/esm/ImmutableURL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableURL.js","sourceRoot":"","sources":["../../src/ImmutableURL.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAqC,MAAM,4BAA4B,CAAC;AAazG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAWrB,KAAM,SAAQ,GAAG;IACV,qBAAqB,CAAY;IAE1C,YAAY,GAAG,IAAe;QAC5B,8GAA8G;QAC9G,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEf,MAAM,iBAAiB,GAAG,CAAC,QAAmB,EAAQ,EAAE;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;gBAC5B,CAAC,QAAQ,CAAC,EAAE;oBACV,YAAY,EAAE,KAAK;oBACnB,GAAG,EAAE,GAAqB,EAAE,CAAC,SAAS;oBACtC,GAAG,EAAE,GAAW,EAAE;wBAChB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;oBAC5E,CAAC;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5B,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAE9B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAEvC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC5B,YAAY,EAAE;gBACZ,YAAY,EAAE,KAAK;gBACnB,GAAG,EAAE,GAA6B,EAAE,CAAC,IAAI,wBAAwB,CAAC,YAAY,CAAC;gBAC/E,GAAG,EAAE,GAAW,EAAE;oBAChB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBAC5E,CAAC;aACD;SACH,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/esm/ImmutableURLSearchParams.d.ts

@@ -0,0 +1,14 @@
+export type ImmutableURLSearchParamsUnbranded = Readonly<Omit<URLSearchParams, 'append' | 'delete' | 'set' | 'sort'>>;
+/**
+ * This is the *instance* type
+ */
+export type ImmutableURLSearchParams = ImmutableURLSearchParamsUnbranded & {
+    readonly __ImmutableURLSearchParams__brand: undefined;
+};
+/**
+ * This is the class/constructor definition
+ */
+export declare const ImmutableURLSearchParams: {
+    readonly prototype: ImmutableURLSearchParams;
+    new (init?: string[][] | Record<string, string> | string | URLSearchParams | ImmutableURLSearchParams): ImmutableURLSearchParams;
+};

package/dist/esm/ImmutableURLSearchParams.js

@@ -0,0 +1,20 @@
+/**
+ * This is the class/constructor definition
+ */
+export const ImmutableURLSearchParams = class extends URLSearchParams {
+    __ImmutableURLSearchParams__brand;
+    append = throwCannotUseMutatingMethodError;
+    delete = throwCannotUseMutatingMethodError;
+    set = throwCannotUseMutatingMethodError;
+    sort = throwCannotUseMutatingMethodError;
+    // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+    constructor(...args) {
+        // @ts-expect-error[TS2345]: Argument of type unknown is not assignable to parameter of type...
+        super(...args);
+    }
+};
+function throwCannotUseMutatingMethodError() {
+    throw new Error('Cannot use a mutating method on an ImmutableURLSearchParams instance');
+}
+;
+//# sourceMappingURL=ImmutableURLSearchParams.js.map

package/dist/esm/ImmutableURLSearchParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImmutableURLSearchParams.js","sourceRoot":"","sources":["../../src/ImmutableURLSearchParams.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAIjC,KAAM,SAAQ,eAAe;IACtB,iCAAiC,CAAY;IAE7C,MAAM,GAAe,iCAAiC,CAAC;IACvD,MAAM,GAAe,iCAAiC,CAAC;IACvD,GAAG,GAAe,iCAAiC,CAAC;IACpD,IAAI,GAAe,iCAAiC,CAAC;IAE9D,qEAAqE;IACrE,YAAY,GAAG,IAAe;QAC5B,+FAA+F;QAC/F,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACjB,CAAC;CACF,CAAC;AAEF,SAAS,iCAAiC;IACxC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;AACJ,CAAC;AAAA,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { ImmutableDate } from './ImmutableDate.js';
+export { ImmutableURL } from './ImmutableURL.js';
+export { ImmutableURLSearchParams } from './ImmutableURLSearchParams.js';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export { ImmutableDate } from './ImmutableDate.js';
+export { ImmutableURL } from './ImmutableURL.js';
+export { ImmutableURLSearchParams } from './ImmutableURLSearchParams.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "immutable-builtins",
+  "version": "1.0.0",
+  "description": "Dependency-free collection of immutable replacements for JavaScript builtins",
+  "keywords": [
+    "immutable",
+    "immutability",
+    "builtins",
+    "readonly",
+    "value-object",
+    "date",
+    "url",
+    "urlsearchparams",
+    "javascript",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/francescosalvi/immutable-builtins.git"
+  },
+  "author": "Francesco Salvi <salvsuperb@gmail.com>",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "files": ["dist"],
+  "types": "./dist/esm/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "main": "./dist/cjs/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "prebuild": "yarn clean",
+    "build": "yarn build:esm && yarn build:cjs",
+    "build:esm": "tsc",
+    "build:cjs": "tsc --module commonjs --outDir dist/cjs",
+    "postbuild:esm": "yarn exec tsc-esm-fix --target='target/es6'",
+    "postbuild:cjs": "echo '{\"type\": \"commonjs\"}' > dist/cjs/package.json",
+    "test": "jest",
+    "lint": "eslint ."
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/eslint": "^9.6.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "24",
+    "date-fns": "^4.1.0",
+    "eslint": "^9.39.2",
+    "jest": "^30.2.0",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "tsc-esm-fix": "^3.1.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0"
+  }
+}