@otp-service/testkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 otp-service contributors
+
+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/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { ChallengeStore, ChallengeRecord, OtpDelivery, DeliveryRequest } from '@otp-service/core';
+
+declare class InMemoryChallengeStore implements ChallengeStore {
+    private readonly records;
+    create(record: ChallengeRecord): Promise<void>;
+    delete(challengeId: string): Promise<void>;
+    get(challengeId: string): Promise<ChallengeRecord | null>;
+    list(): ChallengeRecord[];
+    mustGet(challengeId: string): ChallengeRecord;
+    reset(): void;
+    update(record: ChallengeRecord): Promise<void>;
+}
+declare class RecordingDelivery implements OtpDelivery {
+    readonly requests: DeliveryRequest[];
+    sendChallenge(request: DeliveryRequest): Promise<void>;
+    lastRequest(): DeliveryRequest;
+    reset(): void;
+}
+interface DeterministicOtpGenerator {
+    nextOtp(): string;
+    remaining(): string[];
+    reset(): void;
+}
+declare function createDeterministicOtpGenerator(values: readonly string[]): DeterministicOtpGenerator;
+declare function createFixedClock(isoDate: string): () => Date;
+
+export { type DeterministicOtpGenerator, InMemoryChallengeStore, RecordingDelivery, createDeterministicOtpGenerator, createFixedClock };

package/dist/index.js

@@ -0,0 +1,83 @@
+// src/index.ts
+var InMemoryChallengeStore = class {
+  records = /* @__PURE__ */ new Map();
+  create(record) {
+    this.records.set(record.challengeId, structuredClone(record));
+    return Promise.resolve();
+  }
+  delete(challengeId) {
+    this.records.delete(challengeId);
+    return Promise.resolve();
+  }
+  get(challengeId) {
+    const record = this.records.get(challengeId);
+    return Promise.resolve(record ? structuredClone(record) : null);
+  }
+  list() {
+    return Array.from(this.records.values(), (record) => structuredClone(record));
+  }
+  mustGet(challengeId) {
+    const record = this.records.get(challengeId);
+    if (record === void 0) {
+      throw new Error(`Missing challenge ${challengeId}`);
+    }
+    return structuredClone(record);
+  }
+  reset() {
+    this.records.clear();
+  }
+  update(record) {
+    this.records.set(record.challengeId, structuredClone(record));
+    return Promise.resolve();
+  }
+};
+var RecordingDelivery = class {
+  requests = [];
+  sendChallenge(request) {
+    this.requests.push(structuredClone(request));
+    return Promise.resolve();
+  }
+  lastRequest() {
+    const request = this.requests.at(-1);
+    if (request === void 0) {
+      throw new Error("No delivery requests were recorded.");
+    }
+    return structuredClone(request);
+  }
+  reset() {
+    this.requests.length = 0;
+  }
+};
+function createDeterministicOtpGenerator(values) {
+  if (values.length === 0) {
+    throw new Error("Deterministic OTP generator requires at least one OTP value.");
+  }
+  let index = 0;
+  return {
+    nextOtp() {
+      const value = values[index];
+      if (value === void 0) {
+        throw new Error("Deterministic OTP generator ran out of values.");
+      }
+      index += 1;
+      return value;
+    },
+    remaining() {
+      return [...values.slice(index)];
+    },
+    reset() {
+      index = 0;
+    }
+  };
+}
+function createFixedClock(isoDate) {
+  const fixed = new Date(isoDate);
+  if (Number.isNaN(fixed.getTime())) {
+    throw new Error("Fixed clock requires a valid ISO date.");
+  }
+  return () => new Date(fixed.getTime());
+}
+
+export { InMemoryChallengeStore, RecordingDelivery, createDeterministicOtpGenerator, createFixedClock };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  ChallengeRecord,\n  ChallengeStore,\n  DeliveryRequest,\n  OtpDelivery\n} from \"@otp-service/core\";\n\nexport class InMemoryChallengeStore implements ChallengeStore {\n  private readonly records = new Map<string, ChallengeRecord>();\n\n  create(record: ChallengeRecord): Promise<void> {\n    this.records.set(record.challengeId, structuredClone(record));\n    return Promise.resolve();\n  }\n\n  delete(challengeId: string): Promise<void> {\n    this.records.delete(challengeId);\n    return Promise.resolve();\n  }\n\n  get(challengeId: string): Promise<ChallengeRecord | null> {\n    const record = this.records.get(challengeId);\n    return Promise.resolve(record ? structuredClone(record) : null);\n  }\n\n  list(): ChallengeRecord[] {\n    return Array.from(this.records.values(), (record) => structuredClone(record));\n  }\n\n  mustGet(challengeId: string): ChallengeRecord {\n    const record = this.records.get(challengeId);\n    if (record === undefined) {\n      throw new Error(`Missing challenge ${challengeId}`);\n    }\n\n    return structuredClone(record);\n  }\n\n  reset(): void {\n    this.records.clear();\n  }\n\n  update(record: ChallengeRecord): Promise<void> {\n    this.records.set(record.challengeId, structuredClone(record));\n    return Promise.resolve();\n  }\n}\n\nexport class RecordingDelivery implements OtpDelivery {\n  readonly requests: DeliveryRequest[] = [];\n\n  sendChallenge(request: DeliveryRequest): Promise<void> {\n    this.requests.push(structuredClone(request));\n    return Promise.resolve();\n  }\n\n  lastRequest(): DeliveryRequest {\n    const request = this.requests.at(-1);\n    if (request === undefined) {\n      throw new Error(\"No delivery requests were recorded.\");\n    }\n\n    return structuredClone(request);\n  }\n\n  reset(): void {\n    this.requests.length = 0;\n  }\n}\n\nexport interface DeterministicOtpGenerator {\n  nextOtp(): string;\n  remaining(): string[];\n  reset(): void;\n}\n\nexport function createDeterministicOtpGenerator(\n  values: readonly string[]\n): DeterministicOtpGenerator {\n  if (values.length === 0) {\n    throw new Error(\"Deterministic OTP generator requires at least one OTP value.\");\n  }\n\n  let index = 0;\n\n  return {\n    nextOtp() {\n      const value = values[index];\n      if (value === undefined) {\n        throw new Error(\"Deterministic OTP generator ran out of values.\");\n      }\n\n      index += 1;\n      return value;\n    },\n    remaining() {\n      return [...values.slice(index)];\n    },\n    reset() {\n      index = 0;\n    }\n  };\n}\n\nexport function createFixedClock(isoDate: string): () => Date {\n  const fixed = new Date(isoDate);\n  if (Number.isNaN(fixed.getTime())) {\n    throw new Error(\"Fixed clock requires a valid ISO date.\");\n  }\n\n  return () => new Date(fixed.getTime());\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@otp-service/testkit",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Test doubles and deterministic fixtures for OTP package testing.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Suraj-H/otp-service-package-v2.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Suraj-H/otp-service-package-v2/issues"
+  },
+  "homepage": "https://github.com/Suraj-H/otp-service-package-v2/tree/main/packages/testkit#readme",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@otp-service/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "clean": "rm -rf dist",
+    "lint": "eslint src test",
+    "test": "vitest run --config vitest.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}