@venizia/ignis-helpers 0.2.0-9 → 0.2.0

package/dist/cjs/modules/storage/minio/helper.js

@@ -3,7 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MinioHelper = void 0;
 const error_1 = require("../../error");
 const minio_1 = require("minio");
+const node_stream_1 = require("node:stream");
 const base_1 = require("../base");
+/** @deprecated Use `BunS3Helper` from `@venizia/ignis-helpers/bun-s3`: it reaches MinIO over the same S3 API, and adds presigned URLs, tagging and byte ranges. Removed once that path is settled. */
 class MinioHelper extends base_1.BaseStorageHelper {
     constructor(options) {
         super({
@@ -12,9 +14,9 @@ class MinioHelper extends base_1.BaseStorageHelper {
         });
         this.client = new minio_1.Client(options);
     }
-    async isBucketExists(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
+    async hasBucket(opts) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             return false;
         }
         const isExists = await this.client.bucketExists(name);
@@ -25,28 +27,28 @@ class MinioHelper extends base_1.BaseStorageHelper {
         return buckets;
     }
     async getBucket(opts) {
-        const isExists = await this.isBucketExists(opts);
+        const isExists = await this.hasBucket(opts);
         if (!isExists) {
             return null;
         }
         const buckets = await this.getBuckets();
-        const bucket = buckets.find(el => el.name === opts.name);
+        const bucket = buckets.find(el => el.name === opts.bucket.name);
         return bucket ?? null;
     }
     async createBucket(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             throw (0, error_1.getError)({
                 message: '[createBucket] Invalid name to create bucket!',
             });
         }
         await this.client.makeBucket(name);
-        const bucket = await this.getBucket({ name });
+        const bucket = await this.getBucket(opts);
         return bucket;
     }
     async removeBucket(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             throw (0, error_1.getError)({
                 message: '[removeBucket] Invalid name to remove bucket!',
             });
@@ -58,45 +60,83 @@ class MinioHelper extends base_1.BaseStorageHelper {
         return '/static-assets/';
     }
     async writeObject(opts) {
-        const { bucket, normalizeName, file } = opts;
+        const { bucket, object, file } = opts;
         const { originalName, mimetype: mimeType, buffer, size, encoding } = file;
-        await this.client.putObject(bucket, normalizeName, buffer, size, {
+        await this.client.putObject(bucket.name, object.key, buffer, size, {
             originalName,
-            normalizeName,
+            normalizeName: object.key,
             size,
             encoding,
             mimeType,
         });
     }
-    getFile(opts) {
-        const { bucket, name, options } = opts;
-        return this.client.getObject(bucket, name, options);
+    async getObject(opts) {
+        const { bucket, object, options } = opts;
+        try {
+            return await this.client.getObject(bucket.name, object.key, options);
+        }
+        catch (error) {
+            throw this.asStorageError({ error, operation: 'getObject', bucket, object });
+        }
+    }
+    /** A native ranged GET, so only the requested bytes leave the server. */
+    async getObjectStream(opts) {
+        const { bucket, object, range } = opts;
+        if (!range) {
+            const whole = await this.getObject({ bucket, object });
+            return node_stream_1.Readable.toWeb(whole);
+        }
+        // HTTP ranges include `end`; minio takes a length.
+        const length = range.end === undefined ? undefined : range.end - range.start + 1;
+        try {
+            const partial = await this.client.getPartialObject(bucket.name, object.key, range.start, length);
+            return node_stream_1.Readable.toWeb(partial);
+        }
+        catch (error) {
+            throw this.asStorageError({ error, operation: 'getObjectStream', bucket, object });
+        }
     }
     async getStat(opts) {
-        const { bucket, name } = opts;
-        const stat = await this.client.statObject(bucket, name);
-        return {
-            size: stat.size,
-            metadata: stat.metaData,
-            lastModified: stat.lastModified,
-            etag: stat.etag,
-            versionId: stat.versionId ?? undefined,
-        };
+        const { bucket, object } = opts;
+        try {
+            const stat = await this.client.statObject(bucket.name, object.key);
+            return {
+                size: stat.size,
+                metadata: stat.metaData,
+                lastModified: stat.lastModified,
+                etag: stat.etag,
+                versionId: stat.versionId ?? undefined,
+            };
+        }
+        catch (error) {
+            throw this.asStorageError({ error, operation: 'getStat', bucket, object });
+        }
     }
     async removeObject(opts) {
-        const { bucket, name } = opts;
-        await this.client.removeObject(bucket, name);
+        const { bucket, object } = opts;
+        await this.client.removeObject(bucket.name, object.key);
     }
     async removeObjects(opts) {
-        const { bucket, names } = opts;
-        await this.client.removeObjects(bucket, names);
+        const { bucket, objects } = opts;
+        await this.client.removeObjects(bucket.name, objects.map(object => object.key));
     }
     async listObjects(opts) {
         const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;
+        // `maxKeys: 0` means zero, not unlimited.
+        const limit = maxKeys ?? Number.POSITIVE_INFINITY;
+        if (limit <= 0) {
+            return [];
+        }
         return new Promise((resolve, reject) => {
             const objects = [];
-            const stream = this.client.listObjects(bucket, prefix, useRecursive);
+            // The driver paginates past 1000 keys; the only cap here is the caller's.
+            const stream = this.client.listObjects(bucket.name, prefix, useRecursive);
+            // `destroy()` stops the stream only eventually; pushing past it mutates a resolved array.
+            let isSettled = false;
             stream.on('data', obj => {
+                if (isSettled) {
+                    return;
+                }
                 objects.push({
                     name: obj.name,
                     size: obj.size,
@@ -104,12 +144,26 @@ class MinioHelper extends base_1.BaseStorageHelper {
                     etag: obj.etag,
                     prefix: obj.prefix,
                 });
-                if (maxKeys && objects.length >= maxKeys) {
+                if (objects.length >= limit) {
+                    isSettled = true;
                     stream.destroy();
+                    resolve(objects);
+                }
+            });
+            stream.on('end', () => {
+                if (isSettled) {
+                    return;
+                }
+                isSettled = true;
+                resolve(objects);
+            });
+            stream.on('error', err => {
+                if (isSettled) {
+                    return;
                 }
+                isSettled = true;
+                reject(err);
             });
-            stream.on('end', () => resolve(objects));
-            stream.on('error', err => reject(err));
         });
     }
 }

package/dist/cjs/modules/storage/minio/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/minio/helper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/minio/helper.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/temporal/adapters/dayjs.d.ts

@@ -0,0 +1,21 @@
+import type { IDayjsFactory, ITemporalAdapter } from '../common/types';
+/**
+ * Time zones through your own `dayjs`, passed in rather than imported: this package never loads
+ * dayjs, and you keep whatever plugins, locale and default zone you configured.
+ *
+ * Only `utcOffset()` is read, which stays right whatever the host zone; dayjs's own `format()`
+ * near the host's daylight-saving change does not, and is never used here. dayjs does misread a
+ * local mean time offset under one hour (London before 1848 reads `-01:15`, not `-00:01:15`);
+ * for such dates use `NativeTemporalAdapter` or `LuxonTemporalAdapter`.
+ */
+export declare class DayjsTemporalAdapter implements ITemporalAdapter {
+    private readonly dayjs;
+    constructor(opts: {
+        dayjs: IDayjsFactory;
+    });
+    getOffsetMilliseconds(opts: {
+        value: Date;
+        timeZone: string;
+    }): number;
+}
+//# sourceMappingURL=dayjs.d.ts.map

package/dist/cjs/modules/temporal/adapters/dayjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dayjs.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/dayjs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUvE;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAE1B,IAAI,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE;IAY1C,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAiBvE"}

package/dist/cjs/modules/temporal/adapters/dayjs.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DayjsTemporalAdapter = void 0;
+const http_1 = require("../../../common/constants/http");
+const error_1 = require("../../error");
+const MILLISECONDS_PER_MINUTE = 60_000;
+/** The Gregorian calendar repeats every 400 years, to the day and the weekday. */
+const GREGORIAN_CYCLE_MILLISECONDS = 146_097 * 86_400_000;
+/** 1000-01-01T00:00:00Z. dayjs reads a year below 100 as 19xx; no zone changed its offset before the 1800s. */
+const FIRST_SAFE_EPOCH = -30_610_224_000_000;
+/**
+ * Time zones through your own `dayjs`, passed in rather than imported: this package never loads
+ * dayjs, and you keep whatever plugins, locale and default zone you configured.
+ *
+ * Only `utcOffset()` is read, which stays right whatever the host zone; dayjs's own `format()`
+ * near the host's daylight-saving change does not, and is never used here. dayjs does misread a
+ * local mean time offset under one hour (London before 1848 reads `-01:15`, not `-00:01:15`);
+ * for such dates use `NativeTemporalAdapter` or `LuxonTemporalAdapter`.
+ */
+class DayjsTemporalAdapter {
+    constructor(opts) {
+        if (typeof opts.dayjs?.tz !== 'function') {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[DayjsTemporalAdapter] dayjs has no `tz` | Extend the utc and timezone plugins first: dayjs.extend(utc), then dayjs.extend(timezone)',
+            });
+        }
+        this.dayjs = opts.dayjs;
+    }
+    getOffsetMilliseconds(opts) {
+        const { value, timeZone } = opts;
+        let epoch = value.getTime();
+        while (epoch < FIRST_SAFE_EPOCH) {
+            epoch += GREGORIAN_CYCLE_MILLISECONDS;
+        }
+        try {
+            return this.dayjs(epoch).tz(timeZone).utcOffset() * MILLISECONDS_PER_MINUTE;
+        }
+        catch (error) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[DayjsTemporalAdapter] no offset for ${timeZone} at ${value.getTime()} | ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+}
+exports.DayjsTemporalAdapter = DayjsTemporalAdapter;
+//# sourceMappingURL=dayjs.js.map

package/dist/cjs/modules/temporal/adapters/dayjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dayjs.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/dayjs.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,2CAA2C;AAG3C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC,kFAAkF;AAClF,MAAM,4BAA4B,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D,+GAA+G;AAC/G,MAAM,gBAAgB,GAAG,CAAC,kBAAkB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAa,oBAAoB;IAG/B,YAAY,IAA8B;QACxC,IAAI,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EACL,sIAAsI;aACzI,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,qBAAqB,CAAC,IAAuC;QAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjC,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,KAAK,GAAG,gBAAgB,EAAE,CAAC;YAChC,KAAK,IAAI,4BAA4B,CAAC;QACxC,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,GAAG,uBAAuB,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,wCAAwC,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC9I,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhCD,oDAgCC"}

package/dist/cjs/modules/temporal/adapters/guards.d.ts

@@ -0,0 +1,4 @@
+import type { ITemporalNamespace } from '../common/types';
+/** A `Temporal` namespace - the runtime's global or a polyfill's - by the one member the adapter drives. */
+export declare const isTemporalNamespace: (value: unknown) => value is ITemporalNamespace;
+//# sourceMappingURL=guards.d.ts.map

package/dist/cjs/modules/temporal/adapters/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,4GAA4G;AAC5G,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,kBAU7D,CAAC"}

package/dist/cjs/modules/temporal/adapters/guards.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTemporalNamespace = void 0;
+/** A `Temporal` namespace - the runtime's global or a polyfill's - by the one member the adapter drives. */
+const isTemporalNamespace = (value) => {
+    if (typeof value !== 'object' || value === null || !('Instant' in value)) {
+        return false;
+    }
+    const instant = value.Instant;
+    return ((typeof instant === 'function' || (typeof instant === 'object' && instant !== null)) &&
+        typeof Reflect.get(instant, 'fromEpochMilliseconds') === 'function');
+};
+exports.isTemporalNamespace = isTemporalNamespace;
+//# sourceMappingURL=guards.js.map

package/dist/cjs/modules/temporal/adapters/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/guards.ts"],"names":[],"mappings":";;;AAEA,4GAA4G;AACrG,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA+B,EAAE;IACjF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,OAAO,CACL,CAAC,OAAO,OAAO,KAAK,UAAU,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC;QACpF,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,CAAC,KAAK,UAAU,CACpE,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,mBAAmB,uBAU9B"}

package/dist/cjs/modules/temporal/adapters/index.d.ts

@@ -0,0 +1,4 @@
+export * from './dayjs';
+export * from './luxon';
+export * from './native';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/temporal/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/cjs/modules/temporal/adapters/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dayjs"), exports);
+__exportStar(require("./luxon"), exports);
+__exportStar(require("./native"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/temporal/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB"}

package/dist/cjs/modules/temporal/adapters/luxon.d.ts

@@ -0,0 +1,13 @@
+import type { ILuxonDateTimeFactory, ITemporalAdapter } from '../common/types';
+/** Time zones through your own Luxon `DateTime`, passed in rather than imported. */
+export declare class LuxonTemporalAdapter implements ITemporalAdapter {
+    private readonly dateTime;
+    constructor(opts: {
+        DateTime: ILuxonDateTimeFactory;
+    });
+    getOffsetMilliseconds(opts: {
+        value: Date;
+        timeZone: string;
+    }): number;
+}
+//# sourceMappingURL=luxon.d.ts.map

package/dist/cjs/modules/temporal/adapters/luxon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luxon.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/luxon.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI/E,oFAAoF;AACpF,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;gBAErC,IAAI,EAAE;QAAE,QAAQ,EAAE,qBAAqB,CAAA;KAAE;IAIrD,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAavE"}

package/dist/cjs/modules/temporal/adapters/luxon.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LuxonTemporalAdapter = void 0;
+const http_1 = require("../../../common/constants/http");
+const error_1 = require("../../error");
+const MILLISECONDS_PER_MINUTE = 60_000;
+/** Time zones through your own Luxon `DateTime`, passed in rather than imported. */
+class LuxonTemporalAdapter {
+    constructor(opts) {
+        this.dateTime = opts.DateTime;
+    }
+    getOffsetMilliseconds(opts) {
+        const { value, timeZone } = opts;
+        const zoned = this.dateTime.fromMillis(value.getTime(), { zone: timeZone });
+        // Luxon answers an unusable zone with an invalid `DateTime` rather than a throw.
+        if (!zoned.isValid) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[LuxonTemporalAdapter] no offset for ${timeZone} at ${value.getTime()} | ${zoned.invalidReason ?? 'invalid'}`,
+            });
+        }
+        return zoned.offset * MILLISECONDS_PER_MINUTE;
+    }
+}
+exports.LuxonTemporalAdapter = LuxonTemporalAdapter;
+//# sourceMappingURL=luxon.js.map

package/dist/cjs/modules/temporal/adapters/luxon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luxon.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/luxon.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,2CAA2C;AAG3C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC,oFAAoF;AACpF,MAAa,oBAAoB;IAG/B,YAAY,IAAyC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,qBAAqB,CAAC,IAAuC;QAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE5E,iFAAiF;QACjF,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,wCAAwC,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,aAAa,IAAI,SAAS,EAAE;aACxH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,GAAG,uBAAuB,CAAC;IAChD,CAAC;CACF;AApBD,oDAoBC"}

package/dist/cjs/modules/temporal/adapters/native.d.ts

@@ -0,0 +1,16 @@
+import type { ITemporalAdapter, ITemporalNamespace } from '../common/types';
+/**
+ * Time zones through the TC39 `Temporal` API: the runtime's global (Bun has it, as do current
+ * browsers), or a polyfill's namespace passed as `temporal`.
+ */
+export declare class NativeTemporalAdapter implements ITemporalAdapter {
+    private readonly temporal;
+    constructor(opts?: {
+        temporal?: ITemporalNamespace;
+    });
+    getOffsetMilliseconds(opts: {
+        value: Date;
+        timeZone: string;
+    }): number;
+}
+//# sourceMappingURL=native.d.ts.map

package/dist/cjs/modules/temporal/adapters/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/native.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK5E;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAA;KAAE;IAcpD,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;CAevE"}

package/dist/cjs/modules/temporal/adapters/native.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeTemporalAdapter = void 0;
+const http_1 = require("../../../common/constants/http");
+const error_1 = require("../../error");
+const guards_1 = require("./guards");
+const NANOSECONDS_PER_MILLISECOND = 1_000_000;
+/**
+ * Time zones through the TC39 `Temporal` API: the runtime's global (Bun has it, as do current
+ * browsers), or a polyfill's namespace passed as `temporal`.
+ */
+class NativeTemporalAdapter {
+    constructor(opts) {
+        const temporal = opts?.temporal ?? Reflect.get(globalThis, 'Temporal');
+        if (!(0, guards_1.isTemporalNamespace)(temporal)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[NativeTemporalAdapter] Temporal is not available on this runtime | Pass a polyfill as `temporal`, or use DayjsTemporalAdapter / LuxonTemporalAdapter',
+            });
+        }
+        this.temporal = temporal;
+    }
+    getOffsetMilliseconds(opts) {
+        const { value, timeZone } = opts;
+        try {
+            const zoned = this.temporal.Instant.fromEpochMilliseconds(value.getTime()).toZonedDateTimeISO(timeZone);
+            return zoned.offsetNanoseconds / NANOSECONDS_PER_MILLISECOND;
+        }
+        catch (error) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[NativeTemporalAdapter] no offset for ${timeZone} at ${value.getTime()} | ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+}
+exports.NativeTemporalAdapter = NativeTemporalAdapter;
+//# sourceMappingURL=native.js.map

package/dist/cjs/modules/temporal/adapters/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/adapters/native.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,2CAA2C;AAE3C,qCAA+C;AAE/C,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAE9C;;;GAGG;AACH,MAAa,qBAAqB;IAGhC,YAAY,IAAwC;QAClD,MAAM,QAAQ,GAAY,IAAI,EAAE,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhF,IAAI,CAAC,IAAA,4BAAmB,EAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EACL,uJAAuJ;aAC1J,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,IAAuC;QAC3D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,kBAAkB,CAC3F,QAAQ,CACT,CAAC;YACF,OAAO,KAAK,CAAC,iBAAiB,GAAG,2BAA2B,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,yCAAyC,QAAQ,OAAO,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC/I,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAhCD,sDAgCC"}

package/dist/cjs/modules/temporal/calendar.d.ts

@@ -0,0 +1,52 @@
+import type { TTemporalUnit } from './common/constants';
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/** The years a four-digit `YYYY` spells - the range every method reads and writes. */
+export declare const MIN_TEMPORAL_YEAR = 1;
+export declare const MAX_TEMPORAL_YEAR = 9999;
+export declare const isSupportedYear: (year: number) => boolean;
+export declare const daysInMonth: (opts: {
+    year: number;
+    month: number;
+}) => number;
+/** `parts` moved by whole days on the calendar, wall time untouched. */
+export declare const shiftDays: (opts: {
+    parts: ITemporalParts;
+    days: number;
+}) => ITemporalParts;
+/** `parts` moved by whole months, the day clamped to the target month: Jan 31 + 1 month is Feb 28. */
+export declare const shiftMonths: (opts: {
+    parts: ITemporalParts;
+    months: number;
+}) => ITemporalParts;
+/** Whether the fields name a day and a time the calendar has - Feb 30, 24:00 and year 0 do not. */
+export declare const isRealDateTime: (opts: {
+    parts: ITemporalParts;
+}) => boolean;
+/** Epoch milliseconds of wall-clock fields read at a fixed offset. */
+export declare const epochAtOffset: (opts: {
+    parts: ITemporalParts;
+    offsetMilliseconds: number;
+}) => number;
+/** The wall clock an instant shows at a fixed offset - pure arithmetic, never the host's zone. */
+export declare const wallClockAt: (opts: {
+    epoch: number;
+    offsetMilliseconds: number;
+}) => IZonedTemporalParts;
+/** Units that measure elapsed time rather than the calendar - 24 hours is not always a day. */
+export declare const EXACT_UNIT_MILLISECONDS: Partial<Record<TTemporalUnit, number>>;
+/** The wall-clock fields alone, without the weekday and the offset. */
+export declare const wallClockOf: (opts: {
+    parts: ITemporalParts;
+}) => ITemporalParts;
+/** The wall-clock start of the unit holding `parts`. Weeks start on Monday. */
+export declare const truncateTo: (opts: {
+    parts: IZonedTemporalParts;
+    unit: TTemporalUnit;
+}) => ITemporalParts;
+/** `parts` moved by whole units on the wall clock - no time zone involved. */
+export declare const shiftWallClock: (opts: {
+    parts: ITemporalParts;
+    amount: number;
+    unit: TTemporalUnit;
+}) => ITemporalParts;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/cjs/modules/temporal/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/calendar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAWtC,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OACS,CAAC;AAEzD,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MACW,CAAC;AAEhF,wEAAwE;AACxE,eAAO,MAAM,SAAS,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,cAUzE,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAG,cAO7E,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,cAAc,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,KAAG,OAkBhE,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,aAAa,GAAI,MAAM;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,KAAG,MAKH,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,WAAW,GAAI,MAAM;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;CAC5B,KAAG,mBAgBH,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAK1E,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,KAAG,cAG7D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,aAAa,CAAC;CACrB,KAAG,cA4BH,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,CAAC;CACrB,KAAG,cAsBH,CAAC"}