@pacspace-io/sdk 0.9.0 → 0.15.2

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 (152) hide show
  1. package/README.md +53 -132
  2. package/dist/blinding-file.d.ts +13 -0
  3. package/dist/blinding-file.d.ts.map +1 -0
  4. package/dist/blinding-guard.d.ts +7 -0
  5. package/dist/blinding-guard.d.ts.map +1 -0
  6. package/dist/blinding.d.ts +32 -0
  7. package/dist/blinding.d.ts.map +1 -0
  8. package/dist/client.d.ts +28 -4
  9. package/dist/client.d.ts.map +1 -1
  10. package/dist/fingerprint.d.ts +26 -5
  11. package/dist/fingerprint.d.ts.map +1 -1
  12. package/dist/index.d.ts +35 -35
  13. package/dist/index.d.ts.map +1 -1
  14. package/dist/index.js +7366 -186
  15. package/dist/index.js.map +7 -1
  16. package/dist/inputs.txt +132 -0
  17. package/dist/records-crypto-libraries.json +42 -0
  18. package/dist/records-crypto-types/proof/hiding-commitment-v1.d.ts +19 -0
  19. package/dist/records-crypto-types/proof/jcs.d.ts +4 -0
  20. package/dist/records-crypto-types/proof/layout-document-v1.d.ts +72 -0
  21. package/dist/records-crypto-types/proof/ledger-head-v1.d.ts +22 -0
  22. package/dist/records-crypto-types/proof/merkle-v2.d.ts +5 -0
  23. package/dist/records-crypto-types/proof/payload-ref-v1.d.ts +17 -0
  24. package/dist/records-crypto-types/proof/seal-input.d.ts +2 -0
  25. package/dist/records-crypto-types/proof/semantic-receipt-v2.d.ts +89 -0
  26. package/dist/records-crypto-types/proof/semantic-receipt-v3.d.ts +20 -0
  27. package/dist/records-crypto-types/proof/slot-encoding-v1.d.ts +169 -0
  28. package/dist/records-crypto-types/records/flag-threads-v1.d.ts +53 -0
  29. package/dist/records-crypto-types/records/labels.d.ts +37 -0
  30. package/dist/records-crypto-types/records/reader-crypto-v1.d.ts +198 -0
  31. package/dist/records-crypto-types/records/reader-link-v1.d.ts +164 -0
  32. package/dist/records-crypto-types/records/shared-record-ack-v2.d.ts +72 -0
  33. package/dist/records-crypto-types/records/signed-acknowledgment-v1.d.ts +38 -0
  34. package/dist/records-crypto-types/records/signed-acknowledgment-v2.d.ts +12 -0
  35. package/dist/records-crypto-types/records/trail-index-v1.d.ts +89 -0
  36. package/dist/records-crypto-types/records/trail-rule.d.ts +54 -0
  37. package/dist/records-crypto-types/records-crypto/asymmetric/ack-flag-notes-v1.d.ts +57 -0
  38. package/dist/records-crypto-types/records-crypto/asymmetric/flag-notes-v1.d.ts +55 -0
  39. package/dist/records-crypto-types/records-crypto/asymmetric/index.d.ts +4 -0
  40. package/dist/records-crypto-types/records-crypto/asymmetric/reader-wraps-v1.d.ts +83 -0
  41. package/dist/records-crypto-types/records-crypto/asymmetric/records-asymmetric-v1.d.ts +201 -0
  42. package/dist/records-crypto-types/records-crypto/base64url.d.ts +3 -0
  43. package/dist/records-crypto-types/records-crypto/blinding-file.d.ts +16 -0
  44. package/dist/records-crypto-types/records-crypto/blinding-value.d.ts +10 -0
  45. package/dist/records-crypto-types/records-crypto/bundle-entry.d.ts +2 -0
  46. package/dist/records-crypto-types/records-crypto/disclosure-envelope-v1.d.ts +42 -0
  47. package/dist/records-crypto-types/records-crypto/held-file.d.ts +17 -0
  48. package/dist/records-crypto-types/records-crypto/hmac-node.d.ts +8 -0
  49. package/dist/records-crypto-types/records-crypto/hmac-web.d.ts +8 -0
  50. package/dist/records-crypto-types/records-crypto/index.d.ts +13 -0
  51. package/dist/records-crypto-types/records-crypto/platform-crypto.d.ts +9 -0
  52. package/dist/records-crypto-types/records-crypto/record-disclosure-v1.d.ts +171 -0
  53. package/dist/records-crypto-types/records-crypto/record-hash-v2.d.ts +49 -0
  54. package/dist/records-crypto-types/records-crypto/record-hash-v3.d.ts +36 -0
  55. package/dist/records-crypto-types/records-crypto/records-encryption-v1.d.ts +185 -0
  56. package/dist/records-crypto-types/records-crypto/wrap-shapes-v1.d.ts +23 -0
  57. package/dist/records-crypto.d.ts +1 -0
  58. package/dist/records-crypto.js +16105 -0
  59. package/dist/records-crypto.js.map +7 -0
  60. package/dist/records-encryption/base64url.d.ts +5 -0
  61. package/dist/records-encryption/base64url.d.ts.map +1 -0
  62. package/dist/records-encryption/encrypted-records.d.ts +338 -0
  63. package/dist/records-encryption/encrypted-records.d.ts.map +1 -0
  64. package/dist/records-encryption/index.d.ts +14 -0
  65. package/dist/records-encryption/index.d.ts.map +1 -0
  66. package/dist/records-encryption/keys.d.ts +40 -0
  67. package/dist/records-encryption/keys.d.ts.map +1 -0
  68. package/dist/records-encryption/loader.d.ts +15 -0
  69. package/dist/records-encryption/loader.d.ts.map +1 -0
  70. package/dist/records-encryption/pin-store-file.d.ts +8 -0
  71. package/dist/records-encryption/pin-store-file.d.ts.map +1 -0
  72. package/dist/records-encryption/pin-store.d.ts +17 -0
  73. package/dist/records-encryption/pin-store.d.ts.map +1 -0
  74. package/dist/records-encryption/transport.d.ts +23 -0
  75. package/dist/records-encryption/transport.d.ts.map +1 -0
  76. package/dist/records-encryption/words.d.ts +40 -0
  77. package/dist/records-encryption/words.d.ts.map +1 -0
  78. package/dist/records-encryption/workspace-secret.d.ts +9 -0
  79. package/dist/records-encryption/workspace-secret.d.ts.map +1 -0
  80. package/dist/resources/records.d.ts +112 -2
  81. package/dist/resources/records.d.ts.map +1 -1
  82. package/dist/types/common.d.ts +0 -8
  83. package/dist/types/common.d.ts.map +1 -1
  84. package/dist/types/config.d.ts +7 -5
  85. package/dist/types/config.d.ts.map +1 -1
  86. package/dist/types/records-encryption.d.ts +136 -0
  87. package/dist/types/records-encryption.d.ts.map +1 -0
  88. package/dist/types/records.d.ts +171 -20
  89. package/dist/types/records.d.ts.map +1 -1
  90. package/dist/types/verify.d.ts +84 -0
  91. package/dist/types/verify.d.ts.map +1 -0
  92. package/dist/webhooks/index.d.ts +1 -1
  93. package/dist/webhooks/index.d.ts.map +1 -1
  94. package/dist/webhooks/index.js +229 -5
  95. package/dist/webhooks/index.js.map +7 -1
  96. package/dist/webhooks/types.d.ts +15 -7
  97. package/dist/webhooks/types.d.ts.map +1 -1
  98. package/dist/workspace-secret-file.d.ts +18 -0
  99. package/dist/workspace-secret-file.d.ts.map +1 -0
  100. package/package.json +16 -13
  101. package/dist/client.js +0 -553
  102. package/dist/client.js.map +0 -1
  103. package/dist/errors/index.js +0 -223
  104. package/dist/errors/index.js.map +0 -1
  105. package/dist/fingerprint.js +0 -132
  106. package/dist/fingerprint.js.map +0 -1
  107. package/dist/resources/balance.d.ts +0 -384
  108. package/dist/resources/balance.d.ts.map +0 -1
  109. package/dist/resources/balance.js +0 -1120
  110. package/dist/resources/balance.js.map +0 -1
  111. package/dist/resources/customers.d.ts +0 -33
  112. package/dist/resources/customers.d.ts.map +0 -1
  113. package/dist/resources/customers.js +0 -26
  114. package/dist/resources/customers.js.map +0 -1
  115. package/dist/resources/internal/batch-transport.d.ts +0 -65
  116. package/dist/resources/internal/batch-transport.d.ts.map +0 -1
  117. package/dist/resources/internal/batch-transport.js +0 -42
  118. package/dist/resources/internal/batch-transport.js.map +0 -1
  119. package/dist/resources/receipts.d.ts +0 -46
  120. package/dist/resources/receipts.d.ts.map +0 -1
  121. package/dist/resources/receipts.js +0 -133
  122. package/dist/resources/receipts.js.map +0 -1
  123. package/dist/resources/records.js +0 -232
  124. package/dist/resources/records.js.map +0 -1
  125. package/dist/resources/submission.d.ts +0 -79
  126. package/dist/resources/submission.d.ts.map +0 -1
  127. package/dist/resources/submission.js +0 -398
  128. package/dist/resources/submission.js.map +0 -1
  129. package/dist/types/balance.d.ts +0 -966
  130. package/dist/types/balance.d.ts.map +0 -1
  131. package/dist/types/balance.js +0 -3
  132. package/dist/types/balance.js.map +0 -1
  133. package/dist/types/common.js +0 -3
  134. package/dist/types/common.js.map +0 -1
  135. package/dist/types/config.js +0 -3
  136. package/dist/types/config.js.map +0 -1
  137. package/dist/types/records.js +0 -5
  138. package/dist/types/records.js.map +0 -1
  139. package/dist/types/submission.d.ts +0 -125
  140. package/dist/types/submission.d.ts.map +0 -1
  141. package/dist/types/submission.js +0 -3
  142. package/dist/types/submission.js.map +0 -1
  143. package/dist/utils/polling.d.ts +0 -32
  144. package/dist/utils/polling.d.ts.map +0 -1
  145. package/dist/utils/polling.js +0 -52
  146. package/dist/utils/polling.js.map +0 -1
  147. package/dist/utils/retry.js +0 -21
  148. package/dist/utils/retry.js.map +0 -1
  149. package/dist/webhooks/types.js +0 -3
  150. package/dist/webhooks/types.js.map +0 -1
  151. package/dist/webhooks/verify.js +0 -191
  152. package/dist/webhooks/verify.js.map +0 -1
@@ -0,0 +1,171 @@
1
+ import type { RecordReceipt } from '../proof/semantic-receipt-v3';
2
+ import { type RecordLeafV2, type RevealedLeafV2 } from './record-hash-v2';
3
+ import { type RecordItemV3 } from './record-hash-v3';
4
+ export declare const RECORD_DISCLOSURE_SCHEMA_V1: "record-disclosure/v1";
5
+ export declare const RECORD_DISCLOSURE_SCHEMA_V2: "record-disclosure/v2";
6
+ export declare const RECORD_DISCLOSURE_MAX_BYTES_V1 = 1048576;
7
+ export type RecordDisclosureEntryV1 = {
8
+ seq: number;
9
+ recordOpening: string;
10
+ leaves: string[];
11
+ revealed: RevealedLeafV2[];
12
+ } | {
13
+ seq: number;
14
+ recordOpening: string;
15
+ recordContent: Record<string, unknown>;
16
+ };
17
+ export interface RecordDisclosureV1 {
18
+ schema: typeof RECORD_DISCLOSURE_SCHEMA_V1;
19
+ recordKey: string;
20
+ chain: {
21
+ chainId: number;
22
+ contractAddress: string;
23
+ };
24
+ layout: {
25
+ layoutId: number;
26
+ layoutVersion: number;
27
+ layoutDigest: string;
28
+ };
29
+ recordHashVersion: 1 | 2;
30
+ entries: RecordDisclosureEntryV1[];
31
+ digest: string;
32
+ }
33
+ export interface RecordDisclosureEntryV2 {
34
+ seq: number;
35
+ recordOpening: string;
36
+ items: RecordItemV3[];
37
+ revealed: RevealedLeafV2[];
38
+ }
39
+ export interface RecordDisclosureV2 {
40
+ schema: typeof RECORD_DISCLOSURE_SCHEMA_V2;
41
+ recordKey: string;
42
+ chain: {
43
+ chainId: number;
44
+ contractAddress: string;
45
+ };
46
+ layout: {
47
+ layoutId: number;
48
+ layoutVersion: number;
49
+ layoutDigest: string;
50
+ };
51
+ recordHashVersion: 3;
52
+ entries: RecordDisclosureEntryV2[];
53
+ digest: string;
54
+ }
55
+ export type RecordDisclosure = RecordDisclosureV1 | RecordDisclosureV2;
56
+ export interface RecordReceiptV3Items {
57
+ schema: 'semantic-receipt/v6';
58
+ recordKey: string;
59
+ seq: number;
60
+ recordOpening: string;
61
+ items: RecordItemV3[];
62
+ revealed: RevealedLeafV2[];
63
+ }
64
+ export interface SealHistoryEntryForDisclosureV1 {
65
+ seq: number;
66
+ previousWord: string;
67
+ newWord: string;
68
+ recordHash?: string;
69
+ itemIndex: number;
70
+ itemOpening: string;
71
+ merkleProof: string[];
72
+ batchId: number;
73
+ }
74
+ export interface SealHistoryFormForDisclosureV1 {
75
+ recordKey: string;
76
+ chain: {
77
+ chainId: number;
78
+ contractAddress: string;
79
+ };
80
+ layout: {
81
+ layoutId: number;
82
+ layoutVersion: number;
83
+ layoutDigest: string;
84
+ };
85
+ recordHashVersion?: 3;
86
+ entries: SealHistoryEntryForDisclosureV1[];
87
+ }
88
+ export type ChainBatchRootsV1 = Readonly<Record<string, string>>;
89
+ export type RecordDisclosureRefusalV1 = 'DISCLOSURE_MALFORMED' | 'DISCLOSURE_TOO_LARGE' | 'DISCLOSURE_DIGEST_MISMATCH' | 'DISCLOSURE_RECORD_MISMATCH' | 'DISCLOSURE_ENTRY_NOT_IN_HISTORY' | 'DISCLOSURE_LEAF_MISMATCH' | 'DISCLOSURE_SEAL_MISMATCH' | 'DISCLOSURE_CHAIN_ROOT_MISSING' | 'RECORD_HASH_VERSION_MISMATCH';
90
+ export type RecordDisclosureVerificationV1 = {
91
+ ok: true;
92
+ recordHashVersion: 1 | 2 | 3;
93
+ entries: Array<{
94
+ seq: number;
95
+ batchId: number;
96
+ fields: RecordLeafV2[];
97
+ withheld: number;
98
+ content: Record<string, unknown> | null;
99
+ }>;
100
+ } | {
101
+ ok: false;
102
+ code: RecordDisclosureRefusalV1;
103
+ seq: number | null;
104
+ reason: string;
105
+ };
106
+ export declare class RecordDisclosureError extends Error {
107
+ readonly code: 'DISCLOSURE_MALFORMED' | 'DISCLOSURE_TOO_LARGE';
108
+ constructor(code: 'DISCLOSURE_MALFORMED' | 'DISCLOSURE_TOO_LARGE');
109
+ }
110
+ export declare function computeRecordDisclosureDigestV1(disclosure: Omit<RecordDisclosureV1, 'digest'> & {
111
+ digest?: string;
112
+ }): Promise<string>;
113
+ export declare function computeRecordDisclosureDigestV2(disclosure: Omit<RecordDisclosureV2, 'digest'> & {
114
+ digest?: string;
115
+ }): Promise<string>;
116
+ export declare function computeRecordDisclosureDigest(disclosure: Omit<RecordDisclosure, 'digest'> & {
117
+ digest?: string;
118
+ }): Promise<string>;
119
+ export declare function verifyRecordDisclosureV1(input: {
120
+ form: SealHistoryFormForDisclosureV1;
121
+ chainRoots: ChainBatchRootsV1;
122
+ disclosure: unknown;
123
+ }): Promise<RecordDisclosureVerificationV1>;
124
+ export declare function buildRecordDisclosureV1(input: {
125
+ recordKey: string;
126
+ chain: {
127
+ chainId: number;
128
+ contractAddress: string;
129
+ };
130
+ layout: {
131
+ layoutId: number;
132
+ layoutVersion: number;
133
+ layoutDigest: string;
134
+ };
135
+ entries: Array<{
136
+ receipt: RecordReceipt;
137
+ reveal: 'all' | string[];
138
+ }>;
139
+ }): Promise<RecordDisclosureV1>;
140
+ export declare function buildRecordDisclosureV1(input: {
141
+ recordKey: string;
142
+ chain: {
143
+ chainId: number;
144
+ contractAddress: string;
145
+ };
146
+ layout: {
147
+ layoutId: number;
148
+ layoutVersion: number;
149
+ layoutDigest: string;
150
+ };
151
+ entries: Array<{
152
+ receipt: RecordReceiptV3Items;
153
+ reveal: 'all' | string[];
154
+ }>;
155
+ }): Promise<RecordDisclosureV2>;
156
+ export declare function buildRecordDisclosureV1(input: {
157
+ recordKey: string;
158
+ chain: {
159
+ chainId: number;
160
+ contractAddress: string;
161
+ };
162
+ layout: {
163
+ layoutId: number;
164
+ layoutVersion: number;
165
+ layoutDigest: string;
166
+ };
167
+ entries: Array<{
168
+ receipt: RecordReceipt | RecordReceiptV3Items;
169
+ reveal: 'all' | string[];
170
+ }>;
171
+ }): Promise<RecordDisclosure>;
@@ -0,0 +1,49 @@
1
+ export declare const RECORD_HASH_VERSION_V1: 1;
2
+ export declare const RECORD_HASH_VERSION_V2: 2;
3
+ export type RecordHashVersion = 1 | 2;
4
+ export declare const RECORD_LEAVES_MAX_V2 = 65535;
5
+ export interface RecordLeafV2 {
6
+ pointer: string;
7
+ value: unknown;
8
+ }
9
+ export interface RevealedLeafV2 {
10
+ pointer: string;
11
+ value: unknown;
12
+ salt: string;
13
+ }
14
+ export declare const RECORD_LEAVES_TOO_MANY_V2 = "This entry has more than 65535 fields and list items. Split it across entries.";
15
+ export declare const RECORD_CONTENT_NOT_CANONICAL_V2 = "This entry's sealed fields are not in their canonical form.";
16
+ export declare function parsePointerV2(pointer: unknown): {
17
+ key: string;
18
+ index: number | null;
19
+ } | null;
20
+ export declare function recordLeavesV2(content: Record<string, unknown>): RecordLeafV2[];
21
+ export declare function recordContentFromLeavesV2(leaves: readonly RecordLeafV2[]): Record<string, unknown> | null;
22
+ export declare function newSaltKeyV2(): string;
23
+ export declare function withoutSaltKeysV2<T>(records: T): T;
24
+ export declare function carriesSaltKeyV2(records: unknown): boolean;
25
+ export declare function deriveLeafSaltV2(saltKey: string, pointer: string): Promise<string>;
26
+ export declare function computeLeafHashV2(leaf: RevealedLeafV2): Promise<string>;
27
+ export declare function computeRecordHashV2(leaves: readonly string[]): Promise<string>;
28
+ export declare function commitRecordContentV2(content: Record<string, unknown>, saltKey: string): Promise<{
29
+ recordHash: string;
30
+ leaves: string[];
31
+ revealed: RevealedLeafV2[];
32
+ }>;
33
+ export type OpenRecordEntryV2Result = {
34
+ ok: true;
35
+ recordHash: string;
36
+ fields: RecordLeafV2[];
37
+ withheld: number;
38
+ content: Record<string, unknown> | null;
39
+ } | {
40
+ ok: false;
41
+ failure: 'malformed' | 'leaf-mismatch' | 'not-canonical';
42
+ reason: string;
43
+ };
44
+ export declare function openRecordEntryV2(entry: {
45
+ leaves: readonly string[];
46
+ revealed: readonly RevealedLeafV2[];
47
+ }, options: {
48
+ every: boolean;
49
+ }): Promise<OpenRecordEntryV2Result>;
@@ -0,0 +1,36 @@
1
+ import { type RecordLeafV2, type RevealedLeafV2 } from './record-hash-v2';
2
+ export declare const RECORD_HASH_VERSION_V3: 3;
3
+ export declare const RECORD_ITEMS_MAX_V3 = 65535;
4
+ export declare const RECORD_SLOT_WHOLE_V3 = 65535;
5
+ export type RecordItemV3 = [string, number, string];
6
+ export declare function parsePointerV3(pointer: unknown): {
7
+ key: string;
8
+ index: number | null;
9
+ } | null;
10
+ export declare function memberTagV3(key: string): Promise<string>;
11
+ export declare function deriveLeafSaltV3(saltKey: string, pointer: string): Promise<string>;
12
+ export declare function computeLeafHashV3(leaf: RevealedLeafV2): Promise<string>;
13
+ export declare function validateRecordItemsV3(items: unknown): items is RecordItemV3[];
14
+ export declare function computeRecordHashV3(items: readonly RecordItemV3[]): Promise<string>;
15
+ export declare function commitRecordContentV3(content: Record<string, unknown>, saltKey: string): Promise<{
16
+ recordHash: string;
17
+ items: RecordItemV3[];
18
+ revealed: RevealedLeafV2[];
19
+ }>;
20
+ export type OpenRecordEntryV3Result = {
21
+ ok: true;
22
+ recordHash: string;
23
+ fields: RecordLeafV2[];
24
+ withheld: number;
25
+ content: Record<string, unknown> | null;
26
+ } | {
27
+ ok: false;
28
+ failure: 'malformed' | 'leaf-mismatch' | 'not-canonical';
29
+ reason: string;
30
+ };
31
+ export declare function openRecordEntryV3(entry: {
32
+ items: readonly RecordItemV3[];
33
+ revealed: readonly RevealedLeafV2[];
34
+ }, options: {
35
+ every: boolean;
36
+ }): Promise<OpenRecordEntryV3Result>;
@@ -0,0 +1,185 @@
1
+ export declare const RECORDS_ENCRYPTION_LABELS_V1: {
2
+ readonly idKey: "pacspace:id-key:v1";
3
+ readonly recordsKey: "pacspace:records-key:v1";
4
+ readonly wrapKey: "pacspace:wrap-key:v1";
5
+ readonly recordKey: "pacspace:record-key:v1";
6
+ readonly recordsKeyId: "pacspace:records-key-id:v1";
7
+ readonly wrapKeyId: "pacspace:wrap-key-id:v1";
8
+ readonly recordKeyId: "pacspace:record-key-id:v1";
9
+ readonly recordId: "pacspace:record-id:v1";
10
+ readonly referenceId: "pacspace:reference-id:v1";
11
+ readonly contentTag: "pacspace:content-tag:v1";
12
+ readonly entry: "pacspace:record-entry:v1";
13
+ };
14
+ export declare const RECORDS_CONTENT_TAG_LABELS_V2: {
15
+ readonly contentTagKey: "pacspace:content-tag-key:v2";
16
+ readonly contentTag: "pacspace:content-tag:v2";
17
+ };
18
+ export declare const RECORDS_ENCRYPTION_PAD_BLOCK_V1 = 256;
19
+ export declare const RECORD_ENTRY_PLAINTEXT_MAX_BYTES_V1 = 47104;
20
+ export declare const RECORD_ENTRY_CIPHERTEXT_MAX_BYTES_V1: number;
21
+ export declare const RECORD_ENTRY_CIPHERTEXT_MAX_CHARS_V1: number;
22
+ export declare const RECORD_ENTRY_BODY_MAX_BYTES_V1 = 65536;
23
+ export declare const RECORDS_KEYRING_MAX_BYTES_V1 = 65536;
24
+ export declare const RECORDS_KEYRING_SCHEMA_V1 = "pacspace-workspace-secret/v1";
25
+ export declare const WORKSPACE_SECRET_BYTES_V1 = 32;
26
+ export type RecordsEncryptionCodeV1 = 'RECORDS_KEY_INVALID' | 'RECORDS_KEYRING_MALFORMED' | 'RECORDS_KEYRING_TOO_LARGE' | 'RECORD_ENTRY_MALFORMED' | 'RECORD_ENTRY_TOO_LARGE' | 'RECORD_ENTRY_BODY_TOO_LARGE' | 'RECORD_ENTRY_REFS_MISMATCH' | 'RECORD_ENTRY_HASH_MISMATCH' | 'RECORD_ENVELOPE_MALFORMED' | 'RECORD_ENVELOPE_TOO_LARGE' | 'RECORD_ENVELOPE_WRONG_KEY' | 'RECORD_ENVELOPE_AUTH_FAILED' | 'RECORD_ENVELOPE_PADDING';
27
+ export declare class RecordsEncryptionError extends Error {
28
+ readonly code: RecordsEncryptionCodeV1;
29
+ constructor(code: RecordsEncryptionCodeV1);
30
+ }
31
+ export type RecordsRefusalV1<C extends string = RecordsEncryptionCodeV1> = {
32
+ ok: false;
33
+ code: C;
34
+ };
35
+ declare const INSPECT: unique symbol;
36
+ declare const MINT: unique symbol;
37
+ type Mint = typeof MINT;
38
+ declare abstract class HiddenKey {
39
+ protected constructor(mint: Mint, bytes: Uint8Array);
40
+ protected abstract describe(): string;
41
+ toString(): string;
42
+ toJSON(): string;
43
+ [INSPECT](): string;
44
+ }
45
+ export declare class RecordsIdKeyV1 extends HiddenKey {
46
+ protected describe(): string;
47
+ }
48
+ export declare class RecordsKeyV1 extends HiddenKey {
49
+ readonly version: number;
50
+ readonly id: string;
51
+ protected describe(): string;
52
+ }
53
+ export declare class RecordsWrapKeyV1 extends HiddenKey {
54
+ readonly version: number;
55
+ readonly id: string;
56
+ protected describe(): string;
57
+ }
58
+ export declare class RecordsContentTagKeyV2 extends HiddenKey {
59
+ readonly version: number;
60
+ protected describe(): string;
61
+ }
62
+ export declare class RecordKeyV1 extends HiddenKey {
63
+ readonly id: string;
64
+ readonly recordsKeyId: string | null;
65
+ protected describe(): string;
66
+ }
67
+ type AnyKey = RecordsIdKeyV1 | RecordsKeyV1 | RecordsWrapKeyV1 | RecordKeyV1 | RecordsContentTagKeyV2;
68
+ export declare function exportKeyBytesV1(key: AnyKey): Uint8Array;
69
+ export declare function generateWorkspaceSecretV1(): Uint8Array;
70
+ export declare function deriveRecordsIdKeyV1(secretV1: Uint8Array): Promise<RecordsIdKeyV1>;
71
+ type VersionKeys = {
72
+ recordsKey: RecordsKeyV1;
73
+ wrapKey: RecordsWrapKeyV1;
74
+ contentTagKey: RecordsContentTagKeyV2;
75
+ };
76
+ export declare function deriveRecordsKeysV1(secret: Uint8Array, version: number): Promise<VersionKeys>;
77
+ export declare function importWorkspaceSecretKeyV1(secret: Uint8Array, version: number): Promise<CryptoKey>;
78
+ export declare function deriveRecordsIdKeyFromBaseV1(baseV1: CryptoKey): Promise<RecordsIdKeyV1>;
79
+ export declare function deriveRecordsKeysFromBaseV1(base: CryptoKey, version: number): Promise<VersionKeys>;
80
+ export declare function recordKeyOfV1(recordsKey: RecordsKeyV1, wireRecordId: string): Promise<RecordKeyV1>;
81
+ export declare function recordsKeyFromBytesV1(bytes: Uint8Array, version: number): Promise<RecordsKeyV1>;
82
+ export declare function recordKeyFromBytesV1(bytes: Uint8Array, recordsKeyId?: string | null): Promise<RecordKeyV1>;
83
+ export declare function wireRecordIdV1(idKey: RecordsIdKeyV1, recordType: string, entityId: string): Promise<string>;
84
+ export declare function wireReferenceIdV1(idKey: RecordsIdKeyV1, referenceId: string): Promise<string>;
85
+ export declare function blindedLabelV1(idKey: RecordsIdKeyV1, name: string, value: string): Promise<string>;
86
+ export declare function contentTagV1(idKey: RecordsIdKeyV1, input: {
87
+ recordType: string;
88
+ wireRecordId: string;
89
+ content: Record<string, unknown>;
90
+ lifecycle: string;
91
+ }): Promise<string>;
92
+ export declare function contentTagV2(contentTagKey: RecordsContentTagKeyV2, input: {
93
+ recordType: string;
94
+ wireRecordId: string;
95
+ content: Record<string, unknown>;
96
+ lifecycle: string;
97
+ }): Promise<string>;
98
+ export interface RecordEntryEnvelopeV1 {
99
+ v: 1;
100
+ alg: 'A256GCM';
101
+ kid: string;
102
+ iv: string;
103
+ ct: string;
104
+ }
105
+ export declare function recordEntryPlaintextV1(content: Record<string, unknown>, saltKey: string): Uint8Array;
106
+ export declare function padRecordEntryV1(plaintext: Uint8Array): Uint8Array;
107
+ export declare function sealRecordEntryV1(input: {
108
+ recordKey: RecordKeyV1;
109
+ recordType: string;
110
+ wireRecordId: string;
111
+ content: Record<string, unknown>;
112
+ saltKey: string;
113
+ }): Promise<RecordEntryEnvelopeV1>;
114
+ export declare function readRecordEnvelopeShapeV1(envelope: unknown): {
115
+ ok: true;
116
+ kid: string;
117
+ iv: Uint8Array;
118
+ ct: Uint8Array;
119
+ } | RecordsRefusalV1<'RECORD_ENVELOPE_MALFORMED' | 'RECORD_ENVELOPE_TOO_LARGE'>;
120
+ export type OpenRecordEntryResultV1 = {
121
+ ok: true;
122
+ content: Record<string, unknown>;
123
+ saltKey: string;
124
+ recordsKeyId: string | null;
125
+ } | RecordsRefusalV1<'RECORD_ENVELOPE_MALFORMED' | 'RECORD_ENVELOPE_TOO_LARGE' | 'RECORD_ENVELOPE_WRONG_KEY' | 'RECORD_ENVELOPE_AUTH_FAILED' | 'RECORD_ENVELOPE_PADDING'>;
126
+ export declare function openRecordEntryEnvelopeV1(input: {
127
+ envelope: unknown;
128
+ recordType: string;
129
+ wireRecordId: string;
130
+ recordKey?: RecordKeyV1;
131
+ keyring?: RecordsKeyringV1;
132
+ }): Promise<OpenRecordEntryResultV1>;
133
+ export declare function encryptedWriteBodyBytesV1(body: Record<string, unknown>, recordsKeyId: string, plaintextBytes: number): number;
134
+ export declare function checkEncryptedWriteSizeV1(body: Record<string, unknown>, recordsKeyId: string, plaintextBytes: number): {
135
+ ok: true;
136
+ bodyBytes: number;
137
+ } | (RecordsRefusalV1<'RECORD_ENTRY_TOO_LARGE' | 'RECORD_ENTRY_BODY_TOO_LARGE'> & {
138
+ bodyBytes: number | null;
139
+ });
140
+ export declare function entryRefsMatchV1(content: Record<string, unknown>, outside: {
141
+ amends?: unknown;
142
+ references?: unknown;
143
+ }): {
144
+ ok: true;
145
+ } | RecordsRefusalV1<'RECORD_ENTRY_REFS_MISMATCH'>;
146
+ export interface RecordsKeyProviderV1 {
147
+ versions(): Promise<number[]>;
148
+ secret(version: number): Promise<Uint8Array>;
149
+ }
150
+ export interface RecordsBaseKeyProviderV1 {
151
+ versions(): Promise<number[]>;
152
+ baseKey(version: number): Promise<CryptoKey>;
153
+ }
154
+ export declare class RecordsKeyringV1 {
155
+ #private;
156
+ readonly idKey: RecordsIdKeyV1;
157
+ private constructor();
158
+ static fromProvider(provider: RecordsKeyProviderV1): Promise<RecordsKeyringV1>;
159
+ static fromBaseKeys(provider: RecordsBaseKeyProviderV1): Promise<RecordsKeyringV1>;
160
+ get current(): RecordsKeyV1;
161
+ get versions(): number[];
162
+ byId(id: string): RecordsKeyV1 | null;
163
+ byVersion(version: number): RecordsKeyV1 | null;
164
+ wrapKey(version: number): RecordsWrapKeyV1 | null;
165
+ contentTagKey(version: number): RecordsContentTagKeyV2 | null;
166
+ toString(): string;
167
+ toJSON(): string;
168
+ [INSPECT](): string;
169
+ }
170
+ export declare function localRecordsKeyProviderV1(source: string | ReadonlyArray<{
171
+ version: number;
172
+ secret: Uint8Array;
173
+ }>): RecordsKeyProviderV1;
174
+ export declare function serializeRecordsKeyringFileV1(secrets: ReadonlyArray<{
175
+ version: number;
176
+ secret: Uint8Array;
177
+ }>): string;
178
+ export declare function parseRecordsKeyringFileV1(text: string): {
179
+ ok: true;
180
+ secrets: Array<{
181
+ version: number;
182
+ secret: Uint8Array;
183
+ }>;
184
+ } | RecordsRefusalV1<'RECORDS_KEYRING_MALFORMED' | 'RECORDS_KEYRING_TOO_LARGE'>;
185
+ export {};
@@ -0,0 +1,23 @@
1
+ import type { RecordsRefusalV1 } from './records-encryption-v1';
2
+ export declare const KEY_WRAP_SUITE_V1: "hpke-1";
3
+ export declare const WORKSPACE_PUBLIC_KEY_BYTES_V1 = 1216;
4
+ export declare const KEY_WRAP_ENC_BYTES_V1 = 1120;
5
+ export declare const KEY_WRAP_CT_BYTES_V1 = 48;
6
+ export declare const SEED_WRAP_CT_BYTES_V1 = 48;
7
+ export declare const PUBLIC_KEY_ID_LABEL_V1 = "pacspace:public-key-id:v1";
8
+ export declare function workspacePublicKeyIdV1(publicKey: Uint8Array): Promise<string | null>;
9
+ export declare function readSeedWrapShapeV1(wrap: unknown): {
10
+ ok: true;
11
+ kid: string;
12
+ iv: Uint8Array;
13
+ ct: Uint8Array;
14
+ } | RecordsRefusalV1<'SEED_WRAP_MALFORMED'>;
15
+ type KeyWrapShape = {
16
+ ok: true;
17
+ to: string;
18
+ enc: Uint8Array;
19
+ ct: Uint8Array;
20
+ } | RecordsRefusalV1<'KEY_WRAP_MALFORMED' | 'KEY_WRAP_SUITE'>;
21
+ export declare function readKeyWrapShapeV1(wrap: unknown): KeyWrapShape;
22
+ export declare function readKeyWrapShapeV2(wrap: unknown): KeyWrapShape;
23
+ export {};
@@ -0,0 +1 @@
1
+ export * from './records-crypto-types/records-crypto/bundle-entry';