@pithy-sh/auth 0.15.3 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/README.md +4 -0
  2. package/dist/attestation/appAttest/assertion.d.ts +32 -0
  3. package/dist/attestation/appAttest/assertion.d.ts.map +1 -0
  4. package/dist/attestation/appAttest/assertion.js +59 -0
  5. package/dist/attestation/appAttest/attestation.d.ts +49 -0
  6. package/dist/attestation/appAttest/attestation.d.ts.map +1 -0
  7. package/dist/attestation/appAttest/attestation.js +111 -0
  8. package/dist/attestation/appAttest/authData.d.ts +24 -0
  9. package/dist/attestation/appAttest/authData.d.ts.map +1 -0
  10. package/dist/attestation/appAttest/authData.js +32 -0
  11. package/dist/attestation/appAttest/base64.d.ts +8 -0
  12. package/dist/attestation/appAttest/base64.d.ts.map +1 -0
  13. package/dist/attestation/appAttest/base64.js +27 -0
  14. package/dist/attestation/appAttest/bytes.d.ts +7 -0
  15. package/dist/attestation/appAttest/bytes.d.ts.map +1 -0
  16. package/dist/attestation/appAttest/bytes.js +19 -0
  17. package/dist/attestation/appAttest/cbor.d.ts +20 -0
  18. package/dist/attestation/appAttest/cbor.d.ts.map +1 -0
  19. package/dist/attestation/appAttest/cbor.js +96 -0
  20. package/dist/attestation/appAttest/der.d.ts +38 -0
  21. package/dist/attestation/appAttest/der.d.ts.map +1 -0
  22. package/dist/attestation/appAttest/der.js +106 -0
  23. package/dist/attestation/appAttest/keys.d.ts +15 -0
  24. package/dist/attestation/appAttest/keys.d.ts.map +1 -0
  25. package/dist/attestation/appAttest/keys.js +37 -0
  26. package/dist/attestation/appAttest/root.d.ts +9 -0
  27. package/dist/attestation/appAttest/root.d.ts.map +1 -0
  28. package/dist/attestation/appAttest/root.js +12 -0
  29. package/dist/attestation/appAttest/verifier.d.ts +39 -0
  30. package/dist/attestation/appAttest/verifier.d.ts.map +1 -0
  31. package/dist/attestation/appAttest/verifier.js +121 -0
  32. package/dist/attestation/appAttest/x509.d.ts +50 -0
  33. package/dist/attestation/appAttest/x509.d.ts.map +1 -0
  34. package/dist/attestation/appAttest/x509.js +163 -0
  35. package/dist/attestation/challenge.d.ts +26 -0
  36. package/dist/attestation/challenge.d.ts.map +1 -0
  37. package/dist/attestation/challenge.js +47 -0
  38. package/dist/attestation/config.d.ts +72 -0
  39. package/dist/attestation/config.d.ts.map +1 -0
  40. package/dist/attestation/config.js +52 -0
  41. package/dist/attestation/errors.d.ts +30 -0
  42. package/dist/attestation/errors.d.ts.map +1 -0
  43. package/dist/attestation/errors.js +45 -0
  44. package/dist/attestation/gate.d.ts +27 -0
  45. package/dist/attestation/gate.d.ts.map +1 -0
  46. package/dist/attestation/gate.js +78 -0
  47. package/dist/attestation/playIntegrity/google.d.ts +47 -0
  48. package/dist/attestation/playIntegrity/google.d.ts.map +1 -0
  49. package/dist/attestation/playIntegrity/google.js +178 -0
  50. package/dist/attestation/playIntegrity/verdict.d.ts +40 -0
  51. package/dist/attestation/playIntegrity/verdict.d.ts.map +1 -0
  52. package/dist/attestation/playIntegrity/verdict.js +93 -0
  53. package/dist/attestation/playIntegrity/verifier.d.ts +22 -0
  54. package/dist/attestation/playIntegrity/verifier.d.ts.map +1 -0
  55. package/dist/attestation/playIntegrity/verifier.js +64 -0
  56. package/dist/attestation/verifier.d.ts +60 -0
  57. package/dist/attestation/verifier.d.ts.map +1 -0
  58. package/dist/attestation/verifier.js +46 -0
  59. package/dist/attestation/wire.d.ts +42 -0
  60. package/dist/attestation/wire.d.ts.map +1 -0
  61. package/dist/attestation/wire.js +72 -0
  62. package/dist/capability.d.ts +40 -0
  63. package/dist/capability.d.ts.map +1 -1
  64. package/dist/capability.js +38 -5
  65. package/dist/client/api.d.ts +37 -24
  66. package/dist/client/api.d.ts.map +1 -1
  67. package/dist/client/api.js +52 -41
  68. package/dist/client/attestation.d.ts +148 -0
  69. package/dist/client/attestation.d.ts.map +1 -0
  70. package/dist/client/attestation.js +321 -0
  71. package/dist/client/projection.d.ts +29 -4
  72. package/dist/client/projection.d.ts.map +1 -1
  73. package/dist/data/appAttestKey.d.ts +30 -0
  74. package/dist/data/appAttestKey.d.ts.map +1 -0
  75. package/dist/data/appAttestKey.js +25 -0
  76. package/dist/data/attestationChallenge.d.ts +17 -0
  77. package/dist/data/attestationChallenge.d.ts.map +1 -0
  78. package/dist/data/attestationChallenge.js +19 -0
  79. package/dist/data/tables.d.ts +18 -1
  80. package/dist/data/tables.d.ts.map +1 -1
  81. package/dist/data/tables.js +6 -2
  82. package/dist/http/devLoginRoute.js +3 -3
  83. package/dist/http/resolve.js +1 -1
  84. package/dist/http/responses.d.ts +12 -0
  85. package/dist/http/responses.d.ts.map +1 -1
  86. package/dist/http/responses.js +11 -1
  87. package/dist/http/routes.d.ts +5 -1
  88. package/dist/http/routes.d.ts.map +1 -1
  89. package/dist/http/routes.js +92 -25
  90. package/dist/http/schemas.d.ts +7 -0
  91. package/dist/http/schemas.d.ts.map +1 -1
  92. package/dist/http/schemas.js +7 -1
  93. package/dist/index.js +1 -1
  94. package/dist/instance/secrets.d.ts +86 -7
  95. package/dist/instance/secrets.d.ts.map +1 -1
  96. package/dist/instance/secrets.js +54 -8
  97. package/dist/migrations/0009_attestation_challenges.d.ts +9 -0
  98. package/dist/migrations/0009_attestation_challenges.d.ts.map +1 -0
  99. package/dist/migrations/0009_attestation_challenges.js +21 -0
  100. package/dist/migrations/0010_app_attest_keys.d.ts +9 -0
  101. package/dist/migrations/0010_app_attest_keys.d.ts.map +1 -0
  102. package/dist/migrations/0010_app_attest_keys.js +17 -0
  103. package/dist/migrations/set.d.ts +3 -1
  104. package/dist/migrations/set.d.ts.map +1 -1
  105. package/dist/migrations/set.js +6 -2
  106. package/dist/seeds/devSession.js +1 -1
  107. package/dist/test-utils/appAttestDevice.d.ts +92 -0
  108. package/dist/test-utils/appAttestDevice.d.ts.map +1 -0
  109. package/dist/test-utils/appAttestDevice.js +282 -0
  110. package/dist/test-utils/appAttestSample.d.ts +22 -0
  111. package/dist/test-utils/appAttestSample.d.ts.map +1 -0
  112. package/dist/test-utils/appAttestSample.js +24 -0
  113. package/dist/test-utils/googlePlay.d.ts +47 -0
  114. package/dist/test-utils/googlePlay.d.ts.map +1 -0
  115. package/dist/test-utils/googlePlay.js +117 -0
  116. package/dist/test-utils/liveApp.d.ts +76 -36
  117. package/dist/test-utils/liveApp.d.ts.map +1 -1
  118. package/dist/test-utils/liveApp.js +16 -5
  119. package/dist/test-utils/rollbackThrough.d.ts +11 -0
  120. package/dist/test-utils/rollbackThrough.d.ts.map +1 -0
  121. package/dist/test-utils/rollbackThrough.js +16 -0
  122. package/dist/test-utils/scopedBackend.d.ts +25 -0
  123. package/dist/test-utils/scopedBackend.d.ts.map +1 -1
  124. package/dist/test-utils/scopedBackend.js +1 -1
  125. package/dist/version.generated.d.ts +1 -1
  126. package/dist/version.generated.js +1 -1
  127. package/docs/attestation.md +173 -0
  128. package/package.json +5 -5
  129. package/pithy.manifest.json +14 -0
  130. package/src/attestation/appAttest/assertion.ts +65 -0
  131. package/src/attestation/appAttest/attestation.ts +159 -0
  132. package/src/attestation/appAttest/authData.ts +45 -0
  133. package/src/attestation/appAttest/base64.ts +29 -0
  134. package/src/attestation/appAttest/bytes.ts +18 -0
  135. package/src/attestation/appAttest/cbor.ts +116 -0
  136. package/src/attestation/appAttest/der.ts +126 -0
  137. package/src/attestation/appAttest/keys.ts +57 -0
  138. package/src/attestation/appAttest/root.ts +13 -0
  139. package/src/attestation/appAttest/verifier.ts +113 -0
  140. package/src/attestation/appAttest/x509.ts +209 -0
  141. package/src/attestation/challenge.ts +56 -0
  142. package/src/attestation/config.ts +118 -0
  143. package/src/attestation/errors.ts +60 -0
  144. package/src/attestation/gate.ts +105 -0
  145. package/src/attestation/playIntegrity/google.ts +239 -0
  146. package/src/attestation/playIntegrity/verdict.ts +149 -0
  147. package/src/attestation/playIntegrity/verifier.ts +77 -0
  148. package/src/attestation/verifier.ts +87 -0
  149. package/src/attestation/wire.ts +79 -0
  150. package/src/capability.ts +64 -8
  151. package/src/client/api.ts +73 -40
  152. package/src/client/attestation.ts +404 -0
  153. package/src/client/projection.ts +29 -4
  154. package/src/data/appAttestKey.ts +45 -0
  155. package/src/data/attestationChallenge.ts +23 -0
  156. package/src/data/tables.ts +5 -1
  157. package/src/http/responses.ts +22 -0
  158. package/src/http/routes.ts +128 -38
  159. package/src/http/schemas.ts +24 -0
  160. package/src/instance/secrets.ts +88 -9
  161. package/src/migrations/0009_attestation_challenges.ts +28 -0
  162. package/src/migrations/0010_app_attest_keys.ts +27 -0
  163. package/src/migrations/set.ts +5 -1
  164. package/src/test-utils/appAttestDevice.ts +399 -0
  165. package/src/test-utils/appAttestSample.ts +20 -0
  166. package/src/test-utils/googlePlay.ts +144 -0
  167. package/src/test-utils/liveApp.ts +31 -5
  168. package/src/test-utils/rollbackThrough.ts +24 -0
  169. package/src/version.generated.ts +1 -1
@@ -0,0 +1,9 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import type { Migration } from "kysely/migration";
4
+ /**
5
+ * `pithy_auth_attestation_challenges`: one row per challenge the attestation challenge route issued and nobody
6
+ * has presented yet. See `../attestation/challenge.ts`. Every date is `integer`, ms-epoch.
7
+ */
8
+ export declare const auth_0009_attestation_challenges: Migration;
9
+ //# sourceMappingURL=0009_attestation_challenges.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"0009_attestation_challenges.d.ts","sourceRoot":"","sources":["../../src/migrations/0009_attestation_challenges.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAc9C,CAAC"}
@@ -0,0 +1,21 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ //#region src/migrations/0009_attestation_challenges.ts
4
+ /** How the issue path finds the challenges that have run out. */
5
+ const EXPIRES_INDEX = "pithyAuthAttestationChallengesExpiresAtIdx";
6
+ /**
7
+ * `pithy_auth_attestation_challenges`: one row per challenge the attestation challenge route issued and nobody
8
+ * has presented yet. See `../attestation/challenge.ts`. Every date is `integer`, ms-epoch.
9
+ */
10
+ const auth_0009_attestation_challenges = {
11
+ async up(db) {
12
+ await db.schema.createTable("pithyAuthAttestationChallenges").addColumn("id", "text", (c) => c.primaryKey()).addColumn("issuedAt", "integer", (c) => c.notNull()).addColumn("expiresAt", "integer", (c) => c.notNull()).execute();
13
+ await db.schema.createIndex(EXPIRES_INDEX).on("pithyAuthAttestationChallenges").column("expiresAt").execute();
14
+ },
15
+ async down(db) {
16
+ await db.schema.dropIndex(EXPIRES_INDEX).execute();
17
+ await db.schema.dropTable("pithyAuthAttestationChallenges").execute();
18
+ }
19
+ };
20
+ //#endregion
21
+ export { auth_0009_attestation_challenges };
@@ -0,0 +1,9 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import type { Migration } from "kysely/migration";
4
+ /**
5
+ * `pithy_auth_app_attest_keys`: one row per App Attest key an iOS app registered. See `../data/appAttestKey.ts`.
6
+ * Every date is `integer`, ms-epoch.
7
+ */
8
+ export declare const auth_0010_app_attest_keys: Migration;
9
+ //# sourceMappingURL=0010_app_attest_keys.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"0010_app_attest_keys.d.ts","sourceRoot":"","sources":["../../src/migrations/0010_app_attest_keys.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAgBvC,CAAC"}
@@ -0,0 +1,17 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ //#region src/migrations/0010_app_attest_keys.ts
4
+ /**
5
+ * `pithy_auth_app_attest_keys`: one row per App Attest key an iOS app registered. See `../data/appAttestKey.ts`.
6
+ * Every date is `integer`, ms-epoch.
7
+ */
8
+ const auth_0010_app_attest_keys = {
9
+ async up(db) {
10
+ await db.schema.createTable("pithyAuthAppAttestKeys").addColumn("id", "text", (c) => c.primaryKey()).addColumn("publicKey", "text", (c) => c.notNull()).addColumn("appId", "text", (c) => c.notNull()).addColumn("environment", "text", (c) => c.notNull()).addColumn("counter", "integer", (c) => c.notNull()).addColumn("createdAt", "integer", (c) => c.notNull()).addColumn("lastUsedAt", "integer").execute();
11
+ },
12
+ async down(db) {
13
+ await db.schema.dropTable("pithyAuthAppAttestKeys").execute();
14
+ }
15
+ };
16
+ //#endregion
17
+ export { auth_0010_app_attest_keys };
@@ -10,7 +10,7 @@
10
10
  * migration. Adding a `0002` turned all five into a schema one column short of the code, and the symptom
11
11
  * was `table pithy_auth_sessions has no column named authenticated_at` in thirteen unrelated tests.
12
12
  *
13
- * `0003` through `0007` appended here and reached every reader, which is the point. `0001_init.workers.test.ts` is deliberately not a reader:
13
+ * Every later migration is appended here and reaches every reader, which is the point. `0001_init.workers.test.ts` is deliberately not a reader:
14
14
  * its subject is that one migration's own `up` and `down`, so it names it directly.
15
15
  */
16
16
  export declare const AUTH_MIGRATIONS: {
@@ -22,5 +22,7 @@ export declare const AUTH_MIGRATIONS: {
22
22
  readonly "0006_verification_outcomes": import("kysely/migration").Migration;
23
23
  readonly "0007_erasure_record": import("kysely/migration").Migration;
24
24
  readonly "0008_last_active": import("kysely/migration").Migration;
25
+ readonly "0009_attestation_challenges": import("kysely/migration").Migration;
26
+ readonly "0010_app_attest_keys": import("kysely/migration").Migration;
25
27
  };
26
28
  //# sourceMappingURL=set.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/migrations/set.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe;aAC1B,WAAW;aACX,+BAA+B;aAC/B,8BAA8B;aAC9B,qBAAqB;aACrB,iBAAiB;aACjB,4BAA4B;aAC5B,qBAAqB;aACrB,kBAAkB;CACV,CAAC"}
1
+ {"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/migrations/set.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe;aAC1B,WAAW;aACX,+BAA+B;aAC/B,8BAA8B;aAC9B,qBAAqB;aACrB,iBAAiB;aACjB,4BAA4B;aAC5B,qBAAqB;aACrB,kBAAkB;aAClB,6BAA6B;aAC7B,sBAAsB;CACd,CAAC"}
@@ -8,6 +8,8 @@ import { auth_0005_purge_once } from "./0005_purge_once.js";
8
8
  import { auth_0006_verification_outcomes } from "./0006_verification_outcomes.js";
9
9
  import { auth_0007_erasure_record } from "./0007_erasure_record.js";
10
10
  import { auth_0008_last_active } from "./0008_last_active.js";
11
+ import { auth_0009_attestation_challenges } from "./0009_attestation_challenges.js";
12
+ import { auth_0010_app_attest_keys } from "./0010_app_attest_keys.js";
11
13
  //#region src/migrations/set.ts
12
14
  /**
13
15
  * Every migration `@pithy-sh/auth` ships, keyed as `pithy migrate` composes them.
@@ -19,7 +21,7 @@ import { auth_0008_last_active } from "./0008_last_active.js";
19
21
  * migration. Adding a `0002` turned all five into a schema one column short of the code, and the symptom
20
22
  * was `table pithy_auth_sessions has no column named authenticated_at` in thirteen unrelated tests.
21
23
  *
22
- * `0003` through `0007` appended here and reached every reader, which is the point. `0001_init.workers.test.ts` is deliberately not a reader:
24
+ * Every later migration is appended here and reaches every reader, which is the point. `0001_init.workers.test.ts` is deliberately not a reader:
23
25
  * its subject is that one migration's own `up` and `down`, so it names it directly.
24
26
  */
25
27
  const AUTH_MIGRATIONS = {
@@ -30,7 +32,9 @@ const AUTH_MIGRATIONS = {
30
32
  "0005_purge_once": auth_0005_purge_once,
31
33
  "0006_verification_outcomes": auth_0006_verification_outcomes,
32
34
  "0007_erasure_record": auth_0007_erasure_record,
33
- "0008_last_active": auth_0008_last_active
35
+ "0008_last_active": auth_0008_last_active,
36
+ "0009_attestation_challenges": auth_0009_attestation_challenges,
37
+ "0010_app_attest_keys": auth_0010_app_attest_keys
34
38
  };
35
39
  //#endregion
36
40
  export { AUTH_MIGRATIONS };
@@ -1,7 +1,7 @@
1
1
  // SPDX-FileCopyrightText: 2026 Pithy
2
2
  // SPDX-License-Identifier: MIT
3
- import { DEV_PROTOCOL, sessionCookieName } from "../http/baseUrl.js";
4
3
  import { AUTH_SESSION_SECRET } from "../instance/secrets.js";
4
+ import { DEV_PROTOCOL, sessionCookieName } from "../http/baseUrl.js";
5
5
  import { ValidationError, fromZodError } from "@pithy-sh/core/src/error/pithyError";
6
6
  import { z } from "zod";
7
7
  import { commandName } from "@pithy-sh/core/src/cli/command";
@@ -0,0 +1,92 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ /**
4
+ * A stand-in for Apple's App Attest service and a device's Secure Enclave, built on WebCrypto.
5
+ *
6
+ * It mints a root and an intermediate in the shape Apple's are (P-384, ECDSA with SHA-384), and per key a P-256
7
+ * leaf signed with SHA-256 that carries the nonce extension `1.2.840.113635.100.8.2`, then the attestation object
8
+ * and assertions exactly as `DCAppAttestService` returns them. A test trusts {@link AppAttestAuthority.root} in
9
+ * place of Apple's, which is the only difference from a real device: every byte goes through the same reader.
10
+ */
11
+ type Bytes = Uint8Array;
12
+ /** What to put in one attestation. Each override breaks the one field a refusal test is about. */
13
+ export interface AttestOptions {
14
+ /** `<TeamID>.<bundleId>`, hashed into the authenticator data's `rpIdHash`. */
15
+ appId: string;
16
+ /** What the app passed to `attestKey`. */
17
+ clientDataHash: Bytes;
18
+ environment?: "production" | "development";
19
+ /** The authenticator data's counter. Apple's is always 0. */
20
+ counter?: number;
21
+ /** A nonce to write into the leaf in place of the right one. */
22
+ nonce?: Bytes;
23
+ /** A credential id to write in place of the key id. */
24
+ credentialId?: Bytes;
25
+ /** Leaf validity, defaulting to an hour either side of the authority's `now`. */
26
+ notBefore?: Date;
27
+ notAfter?: Date;
28
+ }
29
+ /** One attested key. */
30
+ export interface AttestedKey {
31
+ /** The key id as `generateKey` hands it over: standard base64 of SHA-256 over the public point. */
32
+ keyId: string;
33
+ /** The attestation object as `attestKey` hands it over: standard base64. */
34
+ attestation: string;
35
+ /** The raw public point. */
36
+ publicKey: Bytes;
37
+ /** An assertion over `clientDataHash`, as `generateAssertion` hands it over: standard base64. */
38
+ assert(options: {
39
+ appId: string;
40
+ clientDataHash: Bytes;
41
+ counter: number;
42
+ }): Promise<string>;
43
+ }
44
+ /** A key generated in the fake Secure Enclave and not yet attested, as `generateKey` leaves it. */
45
+ export interface GeneratedKey {
46
+ /** The key id as `generateKey` hands it over: standard base64 of SHA-256 over the public point. */
47
+ keyId: string;
48
+ /** The raw public point. */
49
+ publicKey: Bytes;
50
+ /** Apple's attestation of this key, as `attestKey` hands it over: standard base64. */
51
+ attest(options: AttestOptions): Promise<string>;
52
+ /** An assertion over `clientDataHash`, as `generateAssertion` hands it over: standard base64. */
53
+ assert(options: {
54
+ appId: string;
55
+ clientDataHash: Bytes;
56
+ counter: number;
57
+ }): Promise<string>;
58
+ }
59
+ /** A fake App Attest service. */
60
+ export interface AppAttestAuthority {
61
+ /** The root to trust in place of Apple's, DER. */
62
+ root: Bytes;
63
+ /** Generate a key and attest to it. */
64
+ attest(options: AttestOptions): Promise<AttestedKey>;
65
+ /** Generate a key, to attest later: the two steps a device takes, `generateKey` then `attestKey`. */
66
+ generate(): Promise<GeneratedKey>;
67
+ }
68
+ /** Stand up a fake App Attest service whose certificates are valid around `now`. */
69
+ export declare function appAttestAuthority(options?: {
70
+ now?: Date;
71
+ }): Promise<AppAttestAuthority>;
72
+ /** A key id as auth stores it: base64url of the 32 bytes. */
73
+ export declare function storedKeyId(keyId: string): string;
74
+ /** A fake device's `@expo/app-integrity`: the shape `appAttestAttester` takes, over `authority`'s keys. */
75
+ export interface AppAttestDeviceModule {
76
+ readonly isSupported: boolean;
77
+ generateKeyAsync(): Promise<string>;
78
+ attestKeyAsync(keyId: string, challenge: string): Promise<string>;
79
+ generateAssertionAsync(keyId: string, challenge: string): Promise<string>;
80
+ /** Forget every key, as a reinstall or a restore to a new phone does: asserting with one then throws. */
81
+ wipe(): void;
82
+ /** Each call in order, with the string it was handed. */
83
+ readonly calls: string[];
84
+ }
85
+ /**
86
+ * `@expo/app-integrity`'s App Attest half on a fake device: the key lives in `authority`'s Secure Enclave stand-in,
87
+ * and each call hashes the string it is handed with SHA-256 over its UTF-8 into `clientDataHash`, as the native
88
+ * module does. Each key's counter rises by one per assertion, as the Secure Enclave's does.
89
+ */
90
+ export declare function appAttestDeviceModule(authority: AppAttestAuthority, appId: string): AppAttestDeviceModule;
91
+ export {};
92
+ //# sourceMappingURL=appAttestDevice.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"appAttestDevice.d.ts","sourceRoot":"","sources":["../../src/test-utils/appAttestDevice.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AAEH,KAAK,KAAK,GAAG,UAAU,CAAC;AAqKxB,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,cAAc,EAAE,KAAK,CAAC;IACtB,WAAW,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;IAC3C,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,uDAAuD;IACvD,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,iFAAiF;IACjF,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAW;IAC1B,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,CAAC;IACjB,iGAAiG;IACjG,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7F;AAED,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC3B,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,KAAK,CAAC;IACjB,sFAAsF;IACtF,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,iGAAiG;IACjG,MAAM,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7F;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,IAAI,EAAE,KAAK,CAAC;IACZ,uCAAuC;IACvC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrD,qGAAqG;IACrG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACnC;AAED,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8GlG;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,2GAA2G;AAC3G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,yGAAyG;IACzG,IAAI,IAAI,IAAI,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAgCzG"}
@@ -0,0 +1,282 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import { base64UrlEncode } from "@pithy-sh/core/src/controlPlane/token/base64url";
4
+ //#region src/test-utils/appAttestDevice.ts
5
+ function concat(...parts) {
6
+ const out = new Uint8Array(parts.reduce((total, part) => total + part.length, 0));
7
+ let offset = 0;
8
+ for (const part of parts) {
9
+ out.set(part, offset);
10
+ offset += part.length;
11
+ }
12
+ return out;
13
+ }
14
+ function standardBase64(bytes) {
15
+ let binary = "";
16
+ for (const byte of bytes) binary += String.fromCharCode(byte);
17
+ return btoa(binary);
18
+ }
19
+ async function sha256(...parts) {
20
+ return new Uint8Array(await crypto.subtle.digest("SHA-256", concat(...parts)));
21
+ }
22
+ function tlv(tag, content) {
23
+ const length = content.length;
24
+ const header = length < 128 ? [length] : length < 256 ? [129, length] : length < 65536 ? [
25
+ 130,
26
+ length >> 8,
27
+ length & 255
28
+ ] : [
29
+ 131,
30
+ length >> 16,
31
+ length >> 8 & 255,
32
+ length & 255
33
+ ];
34
+ return concat(new Uint8Array([tag, ...header]), content);
35
+ }
36
+ const seq = (...items) => tlv(48, concat(...items));
37
+ const set = (...items) => tlv(49, concat(...items));
38
+ const octets = (bytes) => tlv(4, bytes);
39
+ const bits = (bytes) => tlv(3, concat(new Uint8Array([0]), bytes));
40
+ const utf8 = (text) => tlv(12, new TextEncoder().encode(text));
41
+ function integer(bytes) {
42
+ let start = 0;
43
+ while (start < bytes.length - 1 && bytes[start] === 0) start++;
44
+ const digits = bytes.subarray(start);
45
+ return tlv(2, digits[0] & 128 ? concat(new Uint8Array([0]), digits) : digits);
46
+ }
47
+ function oid(dotted) {
48
+ const [first, second, ...rest] = dotted.split(".").map(Number);
49
+ const out = [first * 40 + second];
50
+ for (const arc of rest) {
51
+ const chunk = [arc & 127];
52
+ for (let value = Math.floor(arc / 128); value > 0; value = Math.floor(value / 128)) chunk.unshift(value & 127 | 128);
53
+ out.push(...chunk);
54
+ }
55
+ return tlv(6, new Uint8Array(out));
56
+ }
57
+ function time(date) {
58
+ const iso = date.toISOString();
59
+ const text = `${iso.slice(2, 4)}${iso.slice(5, 7)}${iso.slice(8, 10)}${iso.slice(11, 13)}${iso.slice(14, 16)}${iso.slice(17, 19)}Z`;
60
+ return tlv(23, new TextEncoder().encode(text));
61
+ }
62
+ const name = (commonName) => seq(set(seq(oid("2.5.4.3"), utf8(commonName))), set(seq(oid("2.5.4.10"), utf8("Apple Inc."))));
63
+ const CURVE_OID = {
64
+ "P-256": "1.2.840.10045.3.1.7",
65
+ "P-384": "1.3.132.0.34"
66
+ };
67
+ const SIGNATURE_OID = {
68
+ "SHA-256": "1.2.840.10045.4.3.2",
69
+ "SHA-384": "1.2.840.10045.4.3.3"
70
+ };
71
+ const FIELD = {
72
+ "P-256": 32,
73
+ "P-384": 48
74
+ };
75
+ async function keyPair(curve) {
76
+ const pair = await crypto.subtle.generateKey({
77
+ name: "ECDSA",
78
+ namedCurve: curve
79
+ }, true, ["sign", "verify"]);
80
+ const point = new Uint8Array(await crypto.subtle.exportKey("raw", pair.publicKey));
81
+ return {
82
+ curve,
83
+ privateKey: pair.privateKey,
84
+ point
85
+ };
86
+ }
87
+ /** An ECDSA signature, DER-encoded as X.509 and App Attest carry it. */
88
+ async function sign(key, hash, data) {
89
+ const raw = new Uint8Array(await crypto.subtle.sign({
90
+ name: "ECDSA",
91
+ hash
92
+ }, key.privateKey, data));
93
+ const size = FIELD[key.curve];
94
+ return seq(integer(raw.subarray(0, size)), integer(raw.subarray(size)));
95
+ }
96
+ async function certificate(spec) {
97
+ const algorithm = seq(oid(SIGNATURE_OID[spec.hash]));
98
+ const spki = seq(seq(oid("1.2.840.10045.2.1"), oid(CURVE_OID[spec.subjectKey.curve])), bits(spec.subjectKey.point));
99
+ const extensions = [...spec.ca ? [seq(oid("2.5.29.19"), tlv(1, new Uint8Array([255])), octets(seq(tlv(1, new Uint8Array([255])))))] : [], ...spec.extensions ?? []];
100
+ const tbs = seq(tlv(160, integer(new Uint8Array([2]))), integer(new Uint8Array([spec.serial >> 8, spec.serial & 255])), algorithm, name(spec.issuer), seq(time(spec.notBefore), time(spec.notAfter)), name(spec.subject), spki, ...extensions.length > 0 ? [tlv(163, seq(...extensions))] : []);
101
+ return seq(tbs, algorithm, bits(await sign(spec.signer, spec.hash, tbs)));
102
+ }
103
+ function cborHead(major, value) {
104
+ if (value < 24) return new Uint8Array([major << 5 | value]);
105
+ if (value < 256) return new Uint8Array([major << 5 | 24, value]);
106
+ if (value < 65536) return new Uint8Array([
107
+ major << 5 | 25,
108
+ value >> 8,
109
+ value & 255
110
+ ]);
111
+ return new Uint8Array([
112
+ major << 5 | 26,
113
+ value >>> 24,
114
+ value >> 16 & 255,
115
+ value >> 8 & 255,
116
+ value & 255
117
+ ]);
118
+ }
119
+ function cbor(value) {
120
+ if (typeof value === "number") return value >= 0 ? cborHead(0, value) : cborHead(1, -1 - value);
121
+ if (typeof value === "string") {
122
+ const bytes = new TextEncoder().encode(value);
123
+ return concat(cborHead(3, bytes.length), bytes);
124
+ }
125
+ if (value instanceof Uint8Array) return concat(cborHead(2, value.length), value);
126
+ if (Array.isArray(value)) return concat(cborHead(4, value.length), ...value.map(cbor));
127
+ return concat(cborHead(5, value.size), ...[...value.entries()].flatMap(([k, v]) => [cbor(k), cbor(v)]));
128
+ }
129
+ function uint32(value) {
130
+ return new Uint8Array([
131
+ value >>> 24,
132
+ value >> 16 & 255,
133
+ value >> 8 & 255,
134
+ value & 255
135
+ ]);
136
+ }
137
+ const AAGUID = {
138
+ production: concat(new TextEncoder().encode("appattest"), /* @__PURE__ */ new Uint8Array(7)),
139
+ development: new TextEncoder().encode("appattestdevelop")
140
+ };
141
+ /** Stand up a fake App Attest service whose certificates are valid around `now`. */
142
+ async function appAttestAuthority(options = {}) {
143
+ const now = options.now ?? /* @__PURE__ */ new Date();
144
+ const hours = (n) => new Date(now.getTime() + n * 36e5);
145
+ const rootKey = await keyPair("P-384");
146
+ const intermediateKey = await keyPair("P-384");
147
+ const rootName = "Test App Attestation Root CA";
148
+ const intermediateName = "Test App Attestation CA 1";
149
+ const root = await certificate({
150
+ serial: 1,
151
+ issuer: rootName,
152
+ subject: rootName,
153
+ subjectKey: rootKey,
154
+ signer: rootKey,
155
+ hash: "SHA-384",
156
+ notBefore: hours(-8760),
157
+ notAfter: hours(175200),
158
+ ca: true
159
+ });
160
+ const intermediate = await certificate({
161
+ serial: 2,
162
+ issuer: rootName,
163
+ subject: intermediateName,
164
+ subjectKey: intermediateKey,
165
+ signer: rootKey,
166
+ hash: "SHA-384",
167
+ notBefore: hours(-8760),
168
+ notAfter: hours(87600),
169
+ ca: true
170
+ });
171
+ async function generate() {
172
+ const key = await keyPair("P-256");
173
+ const keyId = await sha256(key.point);
174
+ return {
175
+ keyId: standardBase64(keyId),
176
+ publicKey: key.point,
177
+ async attest(spec) {
178
+ const authData = concat(await sha256(new TextEncoder().encode(spec.appId)), new Uint8Array([64]), uint32(spec.counter ?? 0), AAGUID[spec.environment ?? "production"], new Uint8Array([0, (spec.credentialId ?? keyId).length]), spec.credentialId ?? keyId, cbor(/* @__PURE__ */ new Map([
179
+ [1, 2],
180
+ [3, -7],
181
+ [-1, 1],
182
+ [-2, key.point.subarray(1, 33)],
183
+ [-3, key.point.subarray(33)]
184
+ ])));
185
+ const nonce = spec.nonce ?? await sha256(authData, spec.clientDataHash);
186
+ const leaf = await certificate({
187
+ serial: 3,
188
+ issuer: intermediateName,
189
+ subject: Array.from(keyId, (byte) => byte.toString(16).padStart(2, "0")).join(""),
190
+ subjectKey: key,
191
+ signer: intermediateKey,
192
+ hash: "SHA-256",
193
+ notBefore: spec.notBefore ?? hours(-1),
194
+ notAfter: spec.notAfter ?? hours(72),
195
+ ca: false,
196
+ extensions: [seq(oid("1.2.840.113635.100.8.2"), octets(seq(tlv(161, octets(nonce)))))]
197
+ });
198
+ return standardBase64(cbor(/* @__PURE__ */ new Map([
199
+ ["fmt", "apple-appattest"],
200
+ ["attStmt", /* @__PURE__ */ new Map([["x5c", [leaf, intermediate]], ["receipt", new Uint8Array([
201
+ 1,
202
+ 2,
203
+ 3
204
+ ])]])],
205
+ ["authData", authData]
206
+ ])));
207
+ },
208
+ async assert({ appId, clientDataHash, counter }) {
209
+ const authenticatorData = concat(await sha256(new TextEncoder().encode(appId)), new Uint8Array([64]), uint32(counter));
210
+ const signature = await sign(key, "SHA-256", await sha256(authenticatorData, clientDataHash));
211
+ return standardBase64(cbor(/* @__PURE__ */ new Map([["signature", signature], ["authenticatorData", authenticatorData]])));
212
+ }
213
+ };
214
+ }
215
+ return {
216
+ root,
217
+ generate,
218
+ async attest(spec) {
219
+ const key = await generate();
220
+ return {
221
+ keyId: key.keyId,
222
+ attestation: await key.attest(spec),
223
+ publicKey: key.publicKey,
224
+ assert: key.assert
225
+ };
226
+ }
227
+ };
228
+ }
229
+ /** A key id as auth stores it: base64url of the 32 bytes. */
230
+ function storedKeyId(keyId) {
231
+ return base64UrlEncode(Uint8Array.from(atob(keyId), (char) => char.charCodeAt(0)));
232
+ }
233
+ /**
234
+ * `@expo/app-integrity`'s App Attest half on a fake device: the key lives in `authority`'s Secure Enclave stand-in,
235
+ * and each call hashes the string it is handed with SHA-256 over its UTF-8 into `clientDataHash`, as the native
236
+ * module does. Each key's counter rises by one per assertion, as the Secure Enclave's does.
237
+ */
238
+ function appAttestDeviceModule(authority, appId) {
239
+ const keys = /* @__PURE__ */ new Map();
240
+ const calls = [];
241
+ const hash = (text) => sha256(new TextEncoder().encode(text));
242
+ const find = (keyId) => {
243
+ const entry = keys.get(keyId);
244
+ if (entry === void 0) throw new Error("invalidKey");
245
+ return entry;
246
+ };
247
+ return {
248
+ isSupported: true,
249
+ calls,
250
+ async generateKeyAsync() {
251
+ const key = await authority.generate();
252
+ keys.set(key.keyId, {
253
+ key,
254
+ counter: 0
255
+ });
256
+ calls.push(`generateKeyAsync -> ${key.keyId}`);
257
+ return key.keyId;
258
+ },
259
+ async attestKeyAsync(keyId, challenge) {
260
+ calls.push(`attestKeyAsync ${keyId} ${challenge}`);
261
+ return find(keyId).key.attest({
262
+ appId,
263
+ clientDataHash: await hash(challenge)
264
+ });
265
+ },
266
+ async generateAssertionAsync(keyId, challenge) {
267
+ calls.push(`generateAssertionAsync ${keyId} ${challenge}`);
268
+ const entry = find(keyId);
269
+ entry.counter += 1;
270
+ return entry.key.assert({
271
+ appId,
272
+ clientDataHash: await hash(challenge),
273
+ counter: entry.counter
274
+ });
275
+ },
276
+ wipe() {
277
+ keys.clear();
278
+ }
279
+ };
280
+ }
281
+ //#endregion
282
+ export { appAttestAuthority, appAttestDeviceModule, storedKeyId };
@@ -0,0 +1,22 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ /**
4
+ * The sample attestation Apple publishes in its Attestation Object Validation Guide
5
+ * (https://developer.apple.com/documentation/devicecheck/attestation-object-validation-guide): a real device's
6
+ * attestation, in Apple's production environment, chaining to Apple App Attestation Root CA.
7
+ *
8
+ * The app passed the challenge's own bytes to `attestKey` as its client data hash, which is why
9
+ * {@link APPLE_SAMPLE.clientDataHash} is the challenge text and not its digest. Its leaf certificate is valid from
10
+ * 2026-04-20T18:13:12Z to 2026-04-23T18:13:12Z, so it verifies only at a time inside that window.
11
+ */
12
+ export declare const APPLE_SAMPLE: {
13
+ readonly app: {
14
+ readonly teamId: "1234567890";
15
+ readonly bundleId: "com.example.myapp";
16
+ };
17
+ readonly keyId: "zgSY9YSD+7TaDXssY6WlOPVS1K3Lmk+pFhlcSWE+ZV0=";
18
+ readonly clientDataHash: Uint8Array<ArrayBufferLike>;
19
+ readonly at: Date;
20
+ readonly attestation: "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";
21
+ };
22
+ //# sourceMappingURL=appAttestSample.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"appAttestSample.d.ts","sourceRoot":"","sources":["../../src/test-utils/appAttestSample.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;aACvB,GAAG;iBAAI,MAAM,EAAE,YAAY;iBAAE,QAAQ,EAAE,mBAAmB;;aAC1D,KAAK,EAAE,8CAA8C;aACrD,cAAc;aACd,EAAE;aACF,WAAW,EACT,ssPAAssP;CAChsP,CAAC"}
@@ -0,0 +1,24 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ //#region src/test-utils/appAttestSample.ts
4
+ /**
5
+ * The sample attestation Apple publishes in its Attestation Object Validation Guide
6
+ * (https://developer.apple.com/documentation/devicecheck/attestation-object-validation-guide): a real device's
7
+ * attestation, in Apple's production environment, chaining to Apple App Attestation Root CA.
8
+ *
9
+ * The app passed the challenge's own bytes to `attestKey` as its client data hash, which is why
10
+ * {@link APPLE_SAMPLE.clientDataHash} is the challenge text and not its digest. Its leaf certificate is valid from
11
+ * 2026-04-20T18:13:12Z to 2026-04-23T18:13:12Z, so it verifies only at a time inside that window.
12
+ */
13
+ const APPLE_SAMPLE = {
14
+ app: {
15
+ teamId: "1234567890",
16
+ bundleId: "com.example.myapp"
17
+ },
18
+ keyId: "zgSY9YSD+7TaDXssY6WlOPVS1K3Lmk+pFhlcSWE+ZV0=",
19
+ clientDataHash: new TextEncoder().encode("example_server_challenge"),
20
+ at: /* @__PURE__ */ new Date("2026-04-21T12:00:00.000Z"),
21
+ attestation: "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"
22
+ };
23
+ //#endregion
24
+ export { APPLE_SAMPLE };
@@ -0,0 +1,47 @@
1
+ // SPDX-FileCopyrightText: 2026 Pithy
2
+ // SPDX-License-Identifier: MIT
3
+ import type { PlayIntegrityServiceAccount } from "../instance/secrets";
4
+ /** A service account as Google hands it over, with an RSA key made for the test, and the key to verify with. */
5
+ export interface TestServiceAccount {
6
+ account: PlayIntegrityServiceAccount;
7
+ publicKey: CryptoKey;
8
+ }
9
+ /** Make a service account whose `private_key` is a fresh RSA-2048 PKCS#8 PEM. */
10
+ export declare function testServiceAccount(): Promise<TestServiceAccount>;
11
+ /** A JWT's three parts, decoded, and whether its RS256 signature verifies with `publicKey`. */
12
+ export declare function readJwt(jwt: string, publicKey: CryptoKey): Promise<{
13
+ header: Record<string, unknown>;
14
+ claims: Record<string, unknown>;
15
+ verified: boolean;
16
+ }>;
17
+ /** One request the stub saw. */
18
+ export interface SeenRequest {
19
+ url: string;
20
+ method: string;
21
+ headers: Headers;
22
+ body: string;
23
+ }
24
+ /** A recorded answer: a status and a JSON body. */
25
+ export interface StubAnswer {
26
+ status: number;
27
+ body: unknown;
28
+ }
29
+ /**
30
+ * A `fetch` that answers Google's token endpoint and `decodeIntegrityToken`, from the answers it is handed, and
31
+ * records every request. Any other URL is a test fault and throws.
32
+ */
33
+ export declare function googleFetch(answers: {
34
+ token?: StubAnswer | (() => StubAnswer | Promise<StubAnswer>);
35
+ decode?: StubAnswer | ((request: SeenRequest) => StubAnswer | Promise<StubAnswer>);
36
+ }): {
37
+ fetch: typeof fetch;
38
+ seen: SeenRequest[];
39
+ };
40
+ /** A `decodeIntegrityToken` answer that passes, bound to `binding`, as Google records it for a standard request. */
41
+ export declare function passingDecode(binding: Uint8Array, now: Date, packageName?: string): StubAnswer;
42
+ /**
43
+ * A `decodeIntegrityToken` answer that passes, carrying `requestHash` exactly as the app handed it to Play Integrity:
44
+ * Google records the string it was given, so the Worker compares the client's own characters.
45
+ */
46
+ export declare function passingDecodeOf(requestHash: string, now: Date, packageName?: string): StubAnswer;
47
+ //# sourceMappingURL=googlePlay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"googlePlay.d.ts","sourceRoot":"","sources":["../../src/test-utils/googlePlay.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvE,gHAAgH;AAChH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,2BAA2B,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC;CACtB;AAQD,iFAAiF;AACjF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAwBtE;AAED,+FAA+F;AAC/F,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAWlG;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,KAAK,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;CACpF,GAAG;IAAE,KAAK,EAAE,OAAO,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CA2B/C;AAED,oHAAoH;AACpH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,SAAoB,GAAG,UAAU,CAEzG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,SAAoB,GAAG,UAAU,CAsB3G"}