gingersnap 0.26.3 → 0.26.5

package/data/model/model.cjs

@@ -262,12 +262,28 @@ class Model {
     csv(options, config) {
         return Papa.unparse([this.object(options)], config);
     }
-    clone() {
-        const newModel = new (Object.getPrototypeOf(this))();
-        for (const [key, value] of Object.entries(this)) {
-            newModel[key] = !R__namespace.isNil(value) ? R__namespace.clone(value) : value;
+    /**
+     * Creates a deep copy of the current model instance with optional field overrides
+     * @param changes optional field values to override in the cloned model, or a function that receives the deep copied
+     * data and returns the modified data
+     * @returns a new model instance with the same values as the original, with any specified changes applied
+     */
+    clone(changes) {
+        let jsonPayload;
+        const copy = this.object({ keepOptionals: false, removeMissingFields: true });
+        if (changes === undefined) {
+            jsonPayload = copy;
+        }
+        else if (typeof changes === "function") {
+            jsonPayload = changes(copy);
+        }
+        else {
+            for (const key in changes) {
+                copy[key] = changes[key];
+            }
+            jsonPayload = copy;
         }
-        return newModel;
+        return Object.getPrototypeOf(this).constructor.fromJSON(jsonPayload);
     }
     /**
      * Retrieves the schema of the current model based on the selected format

package/data/model/model.d.ts

@@ -204,7 +204,13 @@ export declare class Model {
      * @returns csv string
      */
     csv(options?: ModelExportOptions, config?: Papa.UnparseConfig): string;
-    clone(): any;
+    /**
+     * Creates a deep copy of the current model instance with optional field overrides
+     * @param changes optional field values to override in the cloned model, or a function that receives the deep copied
+     * data and returns the modified data
+     * @returns a new model instance with the same values as the original, with any specified changes applied
+     */
+    clone(changes?: Record<string, any> | ((prev: Record<string, any>) => Record<string, any>)): typeof this;
     /**
      * Retrieves the schema of the current model based on the selected format
      * @param includeTitleAndDraft boolean whether the title and JSON schema draft version should be referenced in the schema

package/data/model/model.mjs

@@ -241,12 +241,28 @@ class Model {
     csv(options, config) {
         return Papa.unparse([this.object(options)], config);
     }
-    clone() {
-        const newModel = new (Object.getPrototypeOf(this))();
-        for (const [key, value] of Object.entries(this)) {
-            newModel[key] = !R.isNil(value) ? R.clone(value) : value;
+    /**
+     * Creates a deep copy of the current model instance with optional field overrides
+     * @param changes optional field values to override in the cloned model, or a function that receives the deep copied
+     * data and returns the modified data
+     * @returns a new model instance with the same values as the original, with any specified changes applied
+     */
+    clone(changes) {
+        let jsonPayload;
+        const copy = this.object({ keepOptionals: false, removeMissingFields: true });
+        if (changes === undefined) {
+            jsonPayload = copy;
+        }
+        else if (typeof changes === "function") {
+            jsonPayload = changes(copy);
+        }
+        else {
+            for (const key in changes) {
+                copy[key] = changes[key];
+            }
+            jsonPayload = copy;
         }
-        return newModel;
+        return Object.getPrototypeOf(this).constructor.fromJSON(jsonPayload);
     }
     /**
      * Retrieves the schema of the current model based on the selected format

package/data-structures/object/Time.cjs

@@ -487,6 +487,29 @@ class Instant {
     static now() {
         return new Instant(new Date().getTime());
     }
+    /**
+     * Creates an Instant from an ISO 8601 string or epoch milliseconds.
+     *
+     * @param value - An ISO 8601 date-time string or epoch milliseconds
+     * @returns An Instant representing the specified moment
+     * @throws {Error} If the input is not a valid ISO 8601 string
+     *
+     * @example
+     * ```ts
+     * const i1 = Instant.from('2024-01-01T12:00:00.000Z');
+     * const i2 = Instant.from(1704110400000); // Epoch milliseconds
+     * ```
+     */
+    static from(value) {
+        if (typeof value === "number") {
+            return new Instant(value);
+        }
+        const timestamp = Date.parse(value);
+        if (isNaN(timestamp)) {
+            throw new Error(`Invalid ISO 8601 date-time format: ${value}`);
+        }
+        return new Instant(timestamp);
+    }
     /**
      * Checks if this instant is in the distant future.
      *

package/data-structures/object/Time.d.ts

@@ -392,6 +392,20 @@ export declare class Instant {
      * ```
      */
     static now(): Instant;
+    /**
+     * Creates an Instant from an ISO 8601 string or epoch milliseconds.
+     *
+     * @param value - An ISO 8601 date-time string or epoch milliseconds
+     * @returns An Instant representing the specified moment
+     * @throws {Error} If the input is not a valid ISO 8601 string
+     *
+     * @example
+     * ```ts
+     * const i1 = Instant.from('2024-01-01T12:00:00.000Z');
+     * const i2 = Instant.from(1704110400000); // Epoch milliseconds
+     * ```
+     */
+    static from(value: string | number): Instant;
     /**
      * Checks if this instant is in the distant future.
      *

package/data-structures/object/Time.mjs

@@ -485,6 +485,29 @@ class Instant {
     static now() {
         return new Instant(new Date().getTime());
     }
+    /**
+     * Creates an Instant from an ISO 8601 string or epoch milliseconds.
+     *
+     * @param value - An ISO 8601 date-time string or epoch milliseconds
+     * @returns An Instant representing the specified moment
+     * @throws {Error} If the input is not a valid ISO 8601 string
+     *
+     * @example
+     * ```ts
+     * const i1 = Instant.from('2024-01-01T12:00:00.000Z');
+     * const i2 = Instant.from(1704110400000); // Epoch milliseconds
+     * ```
+     */
+    static from(value) {
+        if (typeof value === "number") {
+            return new Instant(value);
+        }
+        const timestamp = Date.parse(value);
+        if (isNaN(timestamp)) {
+            throw new Error(`Invalid ISO 8601 date-time format: ${value}`);
+        }
+        return new Instant(timestamp);
+    }
     /**
      * Checks if this instant is in the distant future.
      *

package/package.json

@@ -1 +1 @@
-{"name":"gingersnap","version":"0.26.3","description":"A general purpose library built with the aim of filling the gaps of javascript shortcomings","dependencies":{"@msgpack/msgpack":"^3.0.0-beta2","browser-or-node":"^3.0.0-pre.0","modern-isomorphic-ws":"^1.0.5","object-hash":"^3.0.0","papaparse":"^5.4.1","protobufjs":"^7.2.6","ramda":"^0.30.1","reflect-metadata":"^0.2.2","tslib":"^2.6.3","uuid":"^9.0.1","ws":"^8.16.0","x2js":"^3.4.4"},"author":"CookieNerds LLC","exports":{"./synchronize":{"import":{"types":"./synchronize.d.ts","default":"./synchronize.mjs"},"require":{"types":"./synchronize.d.ts","default":"./synchronize.cjs"}},"./mocks":{"import":{"types":"./mocks.d.ts","default":"./mocks.mjs"},"require":{"types":"./mocks.d.ts","default":"./mocks.cjs"}},"./socket":{"import":{"types":"./socket.d.ts","default":"./socket.mjs"},"require":{"types":"./socket.d.ts","default":"./socket.cjs"}},"./typing/types":{"import":{"types":"./typing/types.d.ts","default":"./typing/types.mjs"},"require":{"types":"./typing/types.d.ts","default":"./typing/types.cjs"}},"./stream":{"import":{"types":"./stream/index.d.ts","default":"./stream.mjs"},"require":{"types":"./stream/index.d.ts","default":"./stream.cjs"}},"./reflection/injector":{"import":{"types":"./reflection/injector.d.ts","default":"./reflection/injector.mjs"},"require":{"types":"./reflection/injector.d.ts","default":"./reflection/injector.cjs"}},"./stream/call":{"import":{"types":"./stream/call.d.ts","default":"./stream/call.mjs"},"require":{"types":"./stream/call.d.ts","default":"./stream/call.cjs"}},"./stream/state":{"import":{"types":"./stream/state.d.ts","default":"./stream/state.mjs"},"require":{"types":"./stream/state.d.ts","default":"./stream/state.cjs"}},"./stream/collector":{"import":{"types":"./stream/collector.d.ts","default":"./stream/collector.mjs"},"require":{"types":"./stream/collector.d.ts","default":"./stream/collector.cjs"}},"./stream/observable":{"import":{"types":"./stream/observable.d.ts","default":"./stream/observable.mjs"},"require":{"types":"./stream/observable.d.ts","default":"./stream/observable.cjs"}},"./networking":{"import":{"types":"./networking/index.d.ts","default":"./networking.mjs"},"require":{"types":"./networking/index.d.ts","default":"./networking.cjs"}},"./managers":{"import":{"types":"./managers/index.d.ts","default":"./managers.mjs"},"require":{"types":"./managers/index.d.ts","default":"./managers.cjs"}},"./future":{"import":{"types":"./future/index.d.ts","default":"./future.mjs"},"require":{"types":"./future/index.d.ts","default":"./future.cjs"}},"./errors":{"import":{"types":"./errors/index.d.ts","default":"./errors.mjs"},"require":{"types":"./errors/index.d.ts","default":"./errors.cjs"}},"./data-structures/array":{"import":{"types":"./data-structures/array/index.d.ts","default":"./data-structures/array.mjs"},"require":{"types":"./data-structures/array/index.d.ts","default":"./data-structures/array.cjs"}},"./data-structures/object":{"import":{"types":"./data-structures/object/index.d.ts","default":"./data-structures/object.mjs"},"require":{"types":"./data-structures/object/index.d.ts","default":"./data-structures/object.cjs"}},"./data/decoders":{"import":{"types":"./data/decoders/index.d.ts","default":"./data/decoders.mjs"},"require":{"types":"./data/decoders/index.d.ts","default":"./data/decoders.cjs"}},"./data/model":{"import":{"types":"./data/model/index.d.ts","default":"./data/model.mjs"},"require":{"types":"./data/model/index.d.ts","default":"./data/model.cjs"}},"./data/bus":{"import":{"types":"./data/bus.d.ts","default":"./data/bus.mjs"},"require":{"types":"./data/bus.d.ts","default":"./data/bus.cjs"}},"./data/AtomicValue":{"import":{"types":"./data/AtomicValue.d.ts","default":"./data/AtomicValue.mjs"},"require":{"types":"./data/AtomicValue.d.ts","default":"./data/AtomicValue.cjs"}},"./data/store":{"import":{"types":"./data/store/index.d.ts","default":"./data/store.mjs"},"require":{"types":"./data/store/index.d.ts","default":"./data/store.cjs"}},"./functools":{"import":{"types":"./functools/index.d.ts","default":"./functools.mjs"},"require":{"types":"./functools/index.d.ts","default":"./functools.cjs"}},"./files":{"import":{"types":"./files.d.ts","default":"./files.mjs"},"require":{"types":"./files.d.ts","default":"./files.cjs"}}}}
+{"name":"gingersnap","version":"0.26.5","description":"A general purpose library built with the aim of filling the gaps of javascript shortcomings","dependencies":{"@msgpack/msgpack":"^3.0.0-beta2","browser-or-node":"^3.0.0-pre.0","modern-isomorphic-ws":"^1.0.5","object-hash":"^3.0.0","papaparse":"^5.4.1","protobufjs":"^7.2.6","ramda":"^0.30.1","reflect-metadata":"^0.2.2","tslib":"^2.6.3","uuid":"^9.0.1","ws":"^8.16.0","x2js":"^3.4.4"},"author":"CookieNerds LLC","exports":{"./synchronize":{"import":{"types":"./synchronize.d.ts","default":"./synchronize.mjs"},"require":{"types":"./synchronize.d.ts","default":"./synchronize.cjs"}},"./mocks":{"import":{"types":"./mocks.d.ts","default":"./mocks.mjs"},"require":{"types":"./mocks.d.ts","default":"./mocks.cjs"}},"./socket":{"import":{"types":"./socket.d.ts","default":"./socket.mjs"},"require":{"types":"./socket.d.ts","default":"./socket.cjs"}},"./typing/types":{"import":{"types":"./typing/types.d.ts","default":"./typing/types.mjs"},"require":{"types":"./typing/types.d.ts","default":"./typing/types.cjs"}},"./stream":{"import":{"types":"./stream/index.d.ts","default":"./stream.mjs"},"require":{"types":"./stream/index.d.ts","default":"./stream.cjs"}},"./reflection/injector":{"import":{"types":"./reflection/injector.d.ts","default":"./reflection/injector.mjs"},"require":{"types":"./reflection/injector.d.ts","default":"./reflection/injector.cjs"}},"./stream/call":{"import":{"types":"./stream/call.d.ts","default":"./stream/call.mjs"},"require":{"types":"./stream/call.d.ts","default":"./stream/call.cjs"}},"./stream/state":{"import":{"types":"./stream/state.d.ts","default":"./stream/state.mjs"},"require":{"types":"./stream/state.d.ts","default":"./stream/state.cjs"}},"./stream/collector":{"import":{"types":"./stream/collector.d.ts","default":"./stream/collector.mjs"},"require":{"types":"./stream/collector.d.ts","default":"./stream/collector.cjs"}},"./stream/observable":{"import":{"types":"./stream/observable.d.ts","default":"./stream/observable.mjs"},"require":{"types":"./stream/observable.d.ts","default":"./stream/observable.cjs"}},"./networking":{"import":{"types":"./networking/index.d.ts","default":"./networking.mjs"},"require":{"types":"./networking/index.d.ts","default":"./networking.cjs"}},"./managers":{"import":{"types":"./managers/index.d.ts","default":"./managers.mjs"},"require":{"types":"./managers/index.d.ts","default":"./managers.cjs"}},"./future":{"import":{"types":"./future/index.d.ts","default":"./future.mjs"},"require":{"types":"./future/index.d.ts","default":"./future.cjs"}},"./errors":{"import":{"types":"./errors/index.d.ts","default":"./errors.mjs"},"require":{"types":"./errors/index.d.ts","default":"./errors.cjs"}},"./data-structures/array":{"import":{"types":"./data-structures/array/index.d.ts","default":"./data-structures/array.mjs"},"require":{"types":"./data-structures/array/index.d.ts","default":"./data-structures/array.cjs"}},"./data-structures/object":{"import":{"types":"./data-structures/object/index.d.ts","default":"./data-structures/object.mjs"},"require":{"types":"./data-structures/object/index.d.ts","default":"./data-structures/object.cjs"}},"./data/decoders":{"import":{"types":"./data/decoders/index.d.ts","default":"./data/decoders.mjs"},"require":{"types":"./data/decoders/index.d.ts","default":"./data/decoders.cjs"}},"./data/model":{"import":{"types":"./data/model/index.d.ts","default":"./data/model.mjs"},"require":{"types":"./data/model/index.d.ts","default":"./data/model.cjs"}},"./data/bus":{"import":{"types":"./data/bus.d.ts","default":"./data/bus.mjs"},"require":{"types":"./data/bus.d.ts","default":"./data/bus.cjs"}},"./data/AtomicValue":{"import":{"types":"./data/AtomicValue.d.ts","default":"./data/AtomicValue.mjs"},"require":{"types":"./data/AtomicValue.d.ts","default":"./data/AtomicValue.cjs"}},"./data/store":{"import":{"types":"./data/store/index.d.ts","default":"./data/store.mjs"},"require":{"types":"./data/store/index.d.ts","default":"./data/store.cjs"}},"./functools":{"import":{"types":"./functools/index.d.ts","default":"./functools.mjs"},"require":{"types":"./functools/index.d.ts","default":"./functools.cjs"}},"./files":{"import":{"types":"./files.d.ts","default":"./files.mjs"},"require":{"types":"./files.d.ts","default":"./files.cjs"}}}}