@purespectrum1/purescore-client 0.7.0

package/lib/validation/validators/required-string.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequiredString = void 0;
+const errors_1 = require("../errors");
+/**
+ * Rejects a missing, empty or whitespace-only string.
+ */
+class RequiredString {
+    constructor(value, fieldName) {
+        this.value = value;
+        this.fieldName = fieldName;
+    }
+    validate() {
+        var _a;
+        if (!((_a = this.value) === null || _a === void 0 ? void 0 : _a.trim()))
+            return new errors_1.RequiredFieldError(this.fieldName);
+    }
+}
+exports.RequiredString = RequiredString;

package/lib/validation/validators/schedule-record.d.ts

@@ -0,0 +1,26 @@
+import { Validator } from '../protocols';
+/**
+ * The fields this rule insists on. Deliberately structural rather than an import
+ * of `ScheduleRecord`: the subject is untrusted JSON that has not earned that
+ * type yet, and claiming it before checking would defeat the check.
+ */
+type MaybeScheduleRecord = {
+    startedAt?: unknown;
+    sent?: unknown;
+    expiry?: unknown;
+    checkpoints?: unknown;
+};
+/**
+ * Rejects a schedule record that is not usable.
+ *
+ * The record is read back from localStorage, which the respondent can edit, so
+ * nothing about its shape can be assumed: a record missing its timestamps or its
+ * checkpoints has to be discarded rather than driven off.
+ */
+export declare class ScheduleRecordShape implements Validator {
+    private readonly record;
+    private readonly fieldName;
+    constructor(record: MaybeScheduleRecord | null | undefined, fieldName: string);
+    validate(): Error | undefined;
+}
+export {};

package/lib/validation/validators/schedule-record.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduleRecordShape = void 0;
+const errors_1 = require("../errors");
+/**
+ * Rejects a schedule record that is not usable.
+ *
+ * The record is read back from localStorage, which the respondent can edit, so
+ * nothing about its shape can be assumed: a record missing its timestamps or its
+ * checkpoints has to be discarded rather than driven off.
+ */
+class ScheduleRecordShape {
+    constructor(record, fieldName) {
+        this.record = record;
+        this.fieldName = fieldName;
+    }
+    validate() {
+        if (!this.record)
+            return new errors_1.InvalidFieldError(this.fieldName, 'is missing');
+        const { startedAt, sent, expiry, checkpoints } = this.record;
+        if (typeof startedAt !== 'number' || typeof sent !== 'number' || typeof expiry !== 'number') {
+            return new errors_1.InvalidFieldError(this.fieldName, 'is missing its timestamps');
+        }
+        if (!Array.isArray(checkpoints) || checkpoints.length === 0) {
+            return new errors_1.InvalidFieldError(this.fieldName, 'has no checkpoints');
+        }
+        const allCheckpointsUsable = checkpoints.every(c => typeof (c === null || c === void 0 ? void 0 : c.n) === 'number' && typeof (c === null || c === void 0 ? void 0 : c.dueAt) === 'number');
+        if (!allCheckpointsUsable) {
+            return new errors_1.InvalidFieldError(this.fieldName, 'has a malformed checkpoint');
+        }
+    }
+}
+exports.ScheduleRecordShape = ScheduleRecordShape;

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@purespectrum1/purescore-client",
+  "description": "A library to identify purescore devices",
+  "version": "0.7.0",
+  "main": "lib/index.js",
+  "scripts": {
+    "clean": "rm -rf lib && rm -rf dist",
+    "build": "tsc && webpack --config webpack.config.js",
+    "build:node": "tsc",
+    "build:browser": "webpack --config webpack.config.js && OUTPUT_NAME=bundle.js webpack --config webpack.config.js",
+    "prepare": "npm run build",
+    "test": "jest",
+    "lint": "npx eslint"
+  },
+  "files": [
+    "lib/**/*"
+  ],
+  "keywords": [
+    "device identifier",
+    "device fingerprints"
+  ],
+  "author": "datastars",
+  "license": "ISC",
+  "dependencies": {
+    "axios": "^1.20.0",
+    "ua-parser-js": "^2.0.10"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
+    "@babel/preset-typescript": "^7.29.7",
+    "@eslint/js": "^9.39.5",
+    "@jest/globals": "^29.7.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@types/eslint__js": "^8.42.3",
+    "@types/jest": "^29.5.14",
+    "@types/ua-parser-js": "^0.7.39",
+    "babel-loader": "^10.1.1",
+    "canvas": "^2.11.2",
+    "core-js": "^3.50.0",
+    "eslint": "^9.39.5",
+    "globals": "^15.15.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "ts-jest": "^29.4.12",
+    "typescript": "^5.9.3",
+    "webpack": "^5.110.3",
+    "webpack-cli": "^6.0.1"
+  }
+}