@checkdigit/time 1.0.0

package/dist/instant.d.ts

@@ -0,0 +1,28 @@
+export declare type ComparisonResult = -1 | 0 | 1;
+/**
+ * Partial implementation of Temporal.Instant, part of the new TC39 Temporal proposal.
+ *
+ * See docs here: https://tc39.es/proposal-temporal/docs/instant.html
+ */
+export declare class Instant {
+    private readonly nanoseconds;
+    constructor(nanoseconds: bigint);
+    static fromEpochSeconds(epochSeconds: number): Instant;
+    static fromEpochMilliseconds(epochMilliseconds: number): Instant;
+    static fromEpochMicroseconds(epochMicroseconds: bigint): Instant;
+    static fromEpochNanoseconds(epochNanoseconds: bigint): Instant;
+    static from(item: Instant | string): Instant;
+    static compare(one: {
+        epochNanoseconds: bigint;
+    }, two: {
+        epochNanoseconds: bigint;
+    }): ComparisonResult;
+    get epochSeconds(): number;
+    get epochMilliseconds(): number;
+    get epochMicroseconds(): bigint;
+    get epochNanoseconds(): bigint;
+    equals(this: Instant, other: Instant): boolean;
+    toString(this: Instant): string;
+    toJSON(this: Instant): string;
+    valueOf(): never;
+}

package/dist/now.d.ts

@@ -0,0 +1,9 @@
+import { Instant } from './instant';
+/**
+ * This returns ever-increasing millisecond-accurate current time values in nanosecond form.
+ *
+ * To simulate nanosecond current time, we take the millisecond based clock and supplement with the HR timer.
+ * Two invocations within the same millisecond will have an accurate nanosecond difference between them, so
+ * this is useful for ensuring unique timestamps in webservices where concurrent execution may be an issue.
+ */
+export declare function instant(): Instant;

package/dist/temporal.d.ts

@@ -0,0 +1,2 @@
+export * from './instant';
+export * as Now from './now';

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@checkdigit/time",
+  "version": "1.0.0",
+  "description": "Standard time handling",
+  "typings": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "prettier": "@checkdigit/prettier-config",
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/checkdigit/time.git"
+  },
+  "author": "Check Digit, LLC",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/checkdigit/time/issues"
+  },
+  "homepage": "https://github.com/checkdigit/time#readme",
+  "devDependencies": {
+    "@checkdigit/eslint-config": "7.3.0",
+    "@checkdigit/jest-config": "^2.0.0",
+    "@checkdigit/prettier-config": "^3.0.0",
+    "@checkdigit/typescript-config": "^3.1.0",
+    "@js-temporal/polyfill": "^0.4.2",
+    "rimraf": "^3.0.2",
+    "ts-node": "^10.9.1"
+  },
+  "scripts": {
+    "postversion": "git push && git push --tags",
+    "lint": "eslint -f unix 'src/**/*.ts'",
+    "lint:fix": "eslint -f unix 'src/**/*.ts' --fix",
+    "prettier": "prettier --ignore-path .gitignore --list-different .",
+    "prettier:fix": "prettier --ignore-path .gitignore --write .",
+    "test": "npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style",
+    "ci:compile": "tsc --noEmit",
+    "ci:test": "jest --coverage=false",
+    "ci:coverage": "jest --coverage=true",
+    "ci:lint": "npm run lint",
+    "ci:style": "npm run prettier"
+  },
+  "jest": {
+    "preset": "@checkdigit/jest-config"
+  },
+  "eslintConfig": {
+    "extends": [
+      "@checkdigit/eslint-config"
+    ],
+    "ignorePatterns": [
+      "src/date-fns/**",
+      "src/date-fns-tz/**"
+    ]
+  }
+}