@atproto/syntax 0.2.1 → 0.3.1
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.
- package/CHANGELOG.md +12 -0
- package/dist/aturi.d.ts +1 -0
- package/dist/aturi.d.ts.map +1 -0
- package/dist/aturi.js +160 -0
- package/dist/aturi.js.map +1 -0
- package/dist/aturi_validation.d.ts +1 -0
- package/dist/aturi_validation.d.ts.map +1 -0
- package/dist/aturi_validation.js +120 -0
- package/dist/aturi_validation.js.map +1 -0
- package/dist/datetime.d.ts +1 -0
- package/dist/datetime.d.ts.map +1 -0
- package/dist/datetime.js +108 -0
- package/dist/datetime.js.map +1 -0
- package/dist/did.d.ts +1 -0
- package/dist/did.d.ts.map +1 -0
- package/dist/did.js +54 -0
- package/dist/did.js.map +1 -0
- package/dist/handle.d.ts +1 -0
- package/dist/handle.d.ts.map +1 -0
- package/dist/handle.js +119 -0
- package/dist/handle.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -603
- package/dist/index.js.map +1 -7
- package/dist/nsid.d.ts +1 -0
- package/dist/nsid.d.ts.map +1 -0
- package/dist/nsid.js +107 -0
- package/dist/nsid.js.map +1 -0
- package/dist/recordkey.d.ts +1 -0
- package/dist/recordkey.d.ts.map +1 -0
- package/dist/recordkey.js +32 -0
- package/dist/recordkey.js.map +1 -0
- package/dist/tid.d.ts +1 -0
- package/dist/tid.d.ts.map +1 -0
- package/dist/tid.js +30 -0
- package/dist/tid.js.map +1 -0
- package/jest.config.js +3 -3
- package/package.json +7 -8
- package/src/aturi_validation.ts +4 -4
- package/src/did.ts +7 -7
- package/src/handle.ts +1 -1
- package/src/nsid.ts +2 -2
- package/src/recordkey.ts +1 -1
- package/src/tid.ts +1 -1
- package/tests/aturi.test.ts +1 -1
- package/tests/datetime.test.ts +3 -3
- package/tests/did.test.ts +2 -2
- package/tests/handle.test.ts +2 -2
- package/tests/nsid.test.ts +2 -2
- package/tests/recordkey.test.ts +2 -2
- package/tests/tid.test.ts +2 -2
- package/tsconfig.build.json +6 -2
- package/tsconfig.build.tsbuildinfo +1 -0
- package/tsconfig.json +5 -8
- package/tsconfig.tests.json +7 -0
- package/tsconfig.tests.tsbuildinfo +1 -0
- package/babel.config.js +0 -1
- package/build.js +0 -22
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @atproto/syntax
|
|
2
2
|
|
|
3
|
+
## 0.3.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#2911](https://github.com/bluesky-social/atproto/pull/2911) [`bac9be2d3`](https://github.com/bluesky-social/atproto/commit/bac9be2d3ec904d1f984a871f43cf89aca17289d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Improve performances of did validation
|
|
8
|
+
|
|
9
|
+
## 0.3.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- [#2169](https://github.com/bluesky-social/atproto/pull/2169) [`f689bd51a`](https://github.com/bluesky-social/atproto/commit/f689bd51a2f4e02d4eca40eb2568a1fcb95494e9) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Build system rework, stop bundling dependencies.
|
|
14
|
+
|
|
3
15
|
## 0.2.1
|
|
4
16
|
|
|
5
17
|
### Patch Changes
|
package/dist/aturi.d.ts
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"aturi.d.ts","sourceRoot":"","sources":["../src/aturi.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAElC,eAAO,MAAM,aAAa,QAEyE,CAAA;AAInG,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,eAAe,CAAA;gBAEjB,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAyBtC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAOnE,IAAI,QAAQ,WAEX;IAED,IAAI,MAAM,WAET;IAED,IAAI,QAAQ,IAII,MAAM,CAFrB;IAED,IAAI,QAAQ,CAAC,CAAC,EAAE,MAAM,EAErB;IAED,IAAI,MAAM,IAII,MAAM,CAFnB;IAED,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;IAED,IAAI,UAAU,IAII,MAAM,CAFvB;IAED,IAAI,UAAU,CAAC,CAAC,EAAE,MAAM,EAIvB;IAED,IAAI,IAAI,IAII,MAAM,CAFjB;IAED,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAKjB;IAED,IAAI,IAAI,WAEP;IAED,QAAQ;CAeT"}
|
package/dist/aturi.js
ADDED
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
14
|
+
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
|
+
};
|
|
16
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
exports.AtUri = exports.ATP_URI_REGEX = void 0;
|
|
18
|
+
__exportStar(require("./aturi_validation"), exports);
|
|
19
|
+
exports.ATP_URI_REGEX =
|
|
20
|
+
// proto- --did-------------- --name---------------- --path---- --query-- --hash--
|
|
21
|
+
/^(at:\/\/)?((?:did:[a-z0-9:%-]+)|(?:[a-z0-9][a-z0-9.:-]*))(\/[^?#\s]*)?(\?[^#\s]+)?(#[^\s]+)?$/i;
|
|
22
|
+
// --path----- --query-- --hash--
|
|
23
|
+
const RELATIVE_REGEX = /^(\/[^?#\s]*)?(\?[^#\s]+)?(#[^\s]+)?$/i;
|
|
24
|
+
class AtUri {
|
|
25
|
+
constructor(uri, base) {
|
|
26
|
+
Object.defineProperty(this, "hash", {
|
|
27
|
+
enumerable: true,
|
|
28
|
+
configurable: true,
|
|
29
|
+
writable: true,
|
|
30
|
+
value: void 0
|
|
31
|
+
});
|
|
32
|
+
Object.defineProperty(this, "host", {
|
|
33
|
+
enumerable: true,
|
|
34
|
+
configurable: true,
|
|
35
|
+
writable: true,
|
|
36
|
+
value: void 0
|
|
37
|
+
});
|
|
38
|
+
Object.defineProperty(this, "pathname", {
|
|
39
|
+
enumerable: true,
|
|
40
|
+
configurable: true,
|
|
41
|
+
writable: true,
|
|
42
|
+
value: void 0
|
|
43
|
+
});
|
|
44
|
+
Object.defineProperty(this, "searchParams", {
|
|
45
|
+
enumerable: true,
|
|
46
|
+
configurable: true,
|
|
47
|
+
writable: true,
|
|
48
|
+
value: void 0
|
|
49
|
+
});
|
|
50
|
+
let parsed;
|
|
51
|
+
if (base) {
|
|
52
|
+
parsed = parse(base);
|
|
53
|
+
if (!parsed) {
|
|
54
|
+
throw new Error(`Invalid at uri: ${base}`);
|
|
55
|
+
}
|
|
56
|
+
const relativep = parseRelative(uri);
|
|
57
|
+
if (!relativep) {
|
|
58
|
+
throw new Error(`Invalid path: ${uri}`);
|
|
59
|
+
}
|
|
60
|
+
Object.assign(parsed, relativep);
|
|
61
|
+
}
|
|
62
|
+
else {
|
|
63
|
+
parsed = parse(uri);
|
|
64
|
+
if (!parsed) {
|
|
65
|
+
throw new Error(`Invalid at uri: ${uri}`);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
this.hash = parsed.hash;
|
|
69
|
+
this.host = parsed.host;
|
|
70
|
+
this.pathname = parsed.pathname;
|
|
71
|
+
this.searchParams = parsed.searchParams;
|
|
72
|
+
}
|
|
73
|
+
static make(handleOrDid, collection, rkey) {
|
|
74
|
+
let str = handleOrDid;
|
|
75
|
+
if (collection)
|
|
76
|
+
str += '/' + collection;
|
|
77
|
+
if (rkey)
|
|
78
|
+
str += '/' + rkey;
|
|
79
|
+
return new AtUri(str);
|
|
80
|
+
}
|
|
81
|
+
get protocol() {
|
|
82
|
+
return 'at:';
|
|
83
|
+
}
|
|
84
|
+
get origin() {
|
|
85
|
+
return `at://${this.host}`;
|
|
86
|
+
}
|
|
87
|
+
get hostname() {
|
|
88
|
+
return this.host;
|
|
89
|
+
}
|
|
90
|
+
set hostname(v) {
|
|
91
|
+
this.host = v;
|
|
92
|
+
}
|
|
93
|
+
get search() {
|
|
94
|
+
return this.searchParams.toString();
|
|
95
|
+
}
|
|
96
|
+
set search(v) {
|
|
97
|
+
this.searchParams = new URLSearchParams(v);
|
|
98
|
+
}
|
|
99
|
+
get collection() {
|
|
100
|
+
return this.pathname.split('/').filter(Boolean)[0] || '';
|
|
101
|
+
}
|
|
102
|
+
set collection(v) {
|
|
103
|
+
const parts = this.pathname.split('/').filter(Boolean);
|
|
104
|
+
parts[0] = v;
|
|
105
|
+
this.pathname = parts.join('/');
|
|
106
|
+
}
|
|
107
|
+
get rkey() {
|
|
108
|
+
return this.pathname.split('/').filter(Boolean)[1] || '';
|
|
109
|
+
}
|
|
110
|
+
set rkey(v) {
|
|
111
|
+
const parts = this.pathname.split('/').filter(Boolean);
|
|
112
|
+
if (!parts[0])
|
|
113
|
+
parts[0] = 'undefined';
|
|
114
|
+
parts[1] = v;
|
|
115
|
+
this.pathname = parts.join('/');
|
|
116
|
+
}
|
|
117
|
+
get href() {
|
|
118
|
+
return this.toString();
|
|
119
|
+
}
|
|
120
|
+
toString() {
|
|
121
|
+
let path = this.pathname || '/';
|
|
122
|
+
if (!path.startsWith('/')) {
|
|
123
|
+
path = `/${path}`;
|
|
124
|
+
}
|
|
125
|
+
let qs = this.searchParams.toString();
|
|
126
|
+
if (qs && !qs.startsWith('?')) {
|
|
127
|
+
qs = `?${qs}`;
|
|
128
|
+
}
|
|
129
|
+
let hash = this.hash;
|
|
130
|
+
if (hash && !hash.startsWith('#')) {
|
|
131
|
+
hash = `#${hash}`;
|
|
132
|
+
}
|
|
133
|
+
return `at://${this.host}${path}${qs}${hash}`;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
exports.AtUri = AtUri;
|
|
137
|
+
function parse(str) {
|
|
138
|
+
const match = exports.ATP_URI_REGEX.exec(str);
|
|
139
|
+
if (match) {
|
|
140
|
+
return {
|
|
141
|
+
hash: match[5] || '',
|
|
142
|
+
host: match[2] || '',
|
|
143
|
+
pathname: match[3] || '',
|
|
144
|
+
searchParams: new URLSearchParams(match[4] || ''),
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
return undefined;
|
|
148
|
+
}
|
|
149
|
+
function parseRelative(str) {
|
|
150
|
+
const match = RELATIVE_REGEX.exec(str);
|
|
151
|
+
if (match) {
|
|
152
|
+
return {
|
|
153
|
+
hash: match[3] || '',
|
|
154
|
+
pathname: match[1] || '',
|
|
155
|
+
searchParams: new URLSearchParams(match[2] || ''),
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
return undefined;
|
|
159
|
+
}
|
|
160
|
+
//# sourceMappingURL=aturi.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"aturi.js","sourceRoot":"","sources":["../src/aturi.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"aturi_validation.d.ts","sourceRoot":"","sources":["../src/aturi_validation.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,gBAAgB,QAAS,MAAM,SA+E3C,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAS,MAAM,KAAG,IAgCnD,CAAA"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ensureValidAtUriRegex = exports.ensureValidAtUri = void 0;
|
|
4
|
+
const handle_1 = require("./handle");
|
|
5
|
+
const did_1 = require("./did");
|
|
6
|
+
const nsid_1 = require("./nsid");
|
|
7
|
+
// Human-readable constraints on ATURI:
|
|
8
|
+
// - following regular URLs, a 8KByte hard total length limit
|
|
9
|
+
// - follows ATURI docs on website
|
|
10
|
+
// - all ASCII characters, no whitespace. non-ASCII could be URL-encoded
|
|
11
|
+
// - starts "at://"
|
|
12
|
+
// - "authority" is a valid DID or a valid handle
|
|
13
|
+
// - optionally, follow "authority" with "/" and valid NSID as start of path
|
|
14
|
+
// - optionally, if NSID given, follow that with "/" and rkey
|
|
15
|
+
// - rkey path component can include URL-encoded ("percent encoded"), or:
|
|
16
|
+
// ALPHA / DIGIT / "-" / "." / "_" / "~" / ":" / "@" / "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
|
|
17
|
+
// [a-zA-Z0-9._~:@!$&'\(\)*+,;=-]
|
|
18
|
+
// - rkey must have at least one char
|
|
19
|
+
// - regardless of path component, a fragment can follow as "#" and then a JSON pointer (RFC-6901)
|
|
20
|
+
const ensureValidAtUri = (uri) => {
|
|
21
|
+
// JSON pointer is pretty different from rest of URI, so split that out first
|
|
22
|
+
const uriParts = uri.split('#');
|
|
23
|
+
if (uriParts.length > 2) {
|
|
24
|
+
throw new Error('ATURI can have at most one "#", separating fragment out');
|
|
25
|
+
}
|
|
26
|
+
const fragmentPart = uriParts[1] || null;
|
|
27
|
+
uri = uriParts[0];
|
|
28
|
+
// check that all chars are boring ASCII
|
|
29
|
+
if (!/^[a-zA-Z0-9._~:@!$&')(*+,;=%/-]*$/.test(uri)) {
|
|
30
|
+
throw new Error('Disallowed characters in ATURI (ASCII)');
|
|
31
|
+
}
|
|
32
|
+
const parts = uri.split('/');
|
|
33
|
+
if (parts.length >= 3 && (parts[0] !== 'at:' || parts[1].length !== 0)) {
|
|
34
|
+
throw new Error('ATURI must start with "at://"');
|
|
35
|
+
}
|
|
36
|
+
if (parts.length < 3) {
|
|
37
|
+
throw new Error('ATURI requires at least method and authority sections');
|
|
38
|
+
}
|
|
39
|
+
try {
|
|
40
|
+
if (parts[2].startsWith('did:')) {
|
|
41
|
+
(0, did_1.ensureValidDid)(parts[2]);
|
|
42
|
+
}
|
|
43
|
+
else {
|
|
44
|
+
(0, handle_1.ensureValidHandle)(parts[2]);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
catch {
|
|
48
|
+
throw new Error('ATURI authority must be a valid handle or DID');
|
|
49
|
+
}
|
|
50
|
+
if (parts.length >= 4) {
|
|
51
|
+
if (parts[3].length === 0) {
|
|
52
|
+
throw new Error('ATURI can not have a slash after authority without a path segment');
|
|
53
|
+
}
|
|
54
|
+
try {
|
|
55
|
+
(0, nsid_1.ensureValidNsid)(parts[3]);
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
throw new Error('ATURI requires first path segment (if supplied) to be valid NSID');
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
if (parts.length >= 5) {
|
|
62
|
+
if (parts[4].length === 0) {
|
|
63
|
+
throw new Error('ATURI can not have a slash after collection, unless record key is provided');
|
|
64
|
+
}
|
|
65
|
+
// would validate rkey here, but there are basically no constraints!
|
|
66
|
+
}
|
|
67
|
+
if (parts.length >= 6) {
|
|
68
|
+
throw new Error('ATURI path can have at most two parts, and no trailing slash');
|
|
69
|
+
}
|
|
70
|
+
if (uriParts.length >= 2 && fragmentPart == null) {
|
|
71
|
+
throw new Error('ATURI fragment must be non-empty and start with slash');
|
|
72
|
+
}
|
|
73
|
+
if (fragmentPart != null) {
|
|
74
|
+
if (fragmentPart.length === 0 || fragmentPart[0] !== '/') {
|
|
75
|
+
throw new Error('ATURI fragment must be non-empty and start with slash');
|
|
76
|
+
}
|
|
77
|
+
// NOTE: enforcing *some* checks here for sanity. Eg, at least no whitespace
|
|
78
|
+
if (!/^\/[a-zA-Z0-9._~:@!$&')(*+,;=%[\]/-]*$/.test(fragmentPart)) {
|
|
79
|
+
throw new Error('Disallowed characters in ATURI fragment (ASCII)');
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
if (uri.length > 8 * 1024) {
|
|
83
|
+
throw new Error('ATURI is far too long');
|
|
84
|
+
}
|
|
85
|
+
};
|
|
86
|
+
exports.ensureValidAtUri = ensureValidAtUri;
|
|
87
|
+
const ensureValidAtUriRegex = (uri) => {
|
|
88
|
+
// simple regex to enforce most constraints via just regex and length.
|
|
89
|
+
// hand wrote this regex based on above constraints. whew!
|
|
90
|
+
const aturiRegex = /^at:\/\/(?<authority>[a-zA-Z0-9._:%-]+)(\/(?<collection>[a-zA-Z0-9-.]+)(\/(?<rkey>[a-zA-Z0-9._~:@!$&%')(*+,;=-]+))?)?(#(?<fragment>\/[a-zA-Z0-9._~:@!$&%')(*+,;=\-[\]/\\]*))?$/;
|
|
91
|
+
const rm = uri.match(aturiRegex);
|
|
92
|
+
if (!rm || !rm.groups) {
|
|
93
|
+
throw new Error("ATURI didn't validate via regex");
|
|
94
|
+
}
|
|
95
|
+
const groups = rm.groups;
|
|
96
|
+
try {
|
|
97
|
+
(0, handle_1.ensureValidHandleRegex)(groups.authority);
|
|
98
|
+
}
|
|
99
|
+
catch {
|
|
100
|
+
try {
|
|
101
|
+
(0, did_1.ensureValidDidRegex)(groups.authority);
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
throw new Error('ATURI authority must be a valid handle or DID');
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
if (groups.collection) {
|
|
108
|
+
try {
|
|
109
|
+
(0, nsid_1.ensureValidNsidRegex)(groups.collection);
|
|
110
|
+
}
|
|
111
|
+
catch {
|
|
112
|
+
throw new Error('ATURI collection path segment must be a valid NSID');
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
if (uri.length > 8 * 1024) {
|
|
116
|
+
throw new Error('ATURI is far too long');
|
|
117
|
+
}
|
|
118
|
+
};
|
|
119
|
+
exports.ensureValidAtUriRegex = ensureValidAtUriRegex;
|
|
120
|
+
//# sourceMappingURL=aturi_validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"aturi_validation.js","sourceRoot":"","sources":["../src/aturi_validation.ts"],"names":[],"mappings":"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"}
|
package/dist/datetime.d.ts
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,IA4BnD,CAAA;AAID,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,OAW/C,CAAA;AAYD,eAAO,MAAM,iBAAiB,UAAW,MAAM,KAAG,MAkCjD,CAAA;AAMD,eAAO,MAAM,uBAAuB,UAAW,MAAM,KAAG,MASvD,CAAA;AAID,qBAAa,oBAAqB,SAAQ,KAAK;CAAG"}
|
package/dist/datetime.js
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.InvalidDatetimeError = exports.normalizeDatetimeAlways = exports.normalizeDatetime = exports.isValidDatetime = exports.ensureValidDatetime = void 0;
|
|
4
|
+
/* Validates datetime string against atproto Lexicon 'datetime' format.
|
|
5
|
+
* Syntax is described at: https://atproto.com/specs/lexicon#datetime
|
|
6
|
+
*/
|
|
7
|
+
const ensureValidDatetime = (dtStr) => {
|
|
8
|
+
const date = new Date(dtStr);
|
|
9
|
+
// must parse as ISO 8601; this also verifies semantics like month is not 13 or 00
|
|
10
|
+
if (isNaN(date.getTime())) {
|
|
11
|
+
throw new InvalidDatetimeError('datetime did not parse as ISO 8601');
|
|
12
|
+
}
|
|
13
|
+
if (date.toISOString().startsWith('-')) {
|
|
14
|
+
throw new InvalidDatetimeError('datetime normalized to a negative time');
|
|
15
|
+
}
|
|
16
|
+
// regex and other checks for RFC-3339
|
|
17
|
+
if (!/^[0-9]{4}-[01][0-9]-[0-3][0-9]T[0-2][0-9]:[0-6][0-9]:[0-6][0-9](.[0-9]{1,20})?(Z|([+-][0-2][0-9]:[0-5][0-9]))$/.test(dtStr)) {
|
|
18
|
+
throw new InvalidDatetimeError("datetime didn't validate via regex");
|
|
19
|
+
}
|
|
20
|
+
if (dtStr.length > 64) {
|
|
21
|
+
throw new InvalidDatetimeError('datetime is too long (64 chars max)');
|
|
22
|
+
}
|
|
23
|
+
if (dtStr.endsWith('-00:00')) {
|
|
24
|
+
throw new InvalidDatetimeError('datetime can not use "-00:00" for UTC timezone');
|
|
25
|
+
}
|
|
26
|
+
if (dtStr.startsWith('000')) {
|
|
27
|
+
throw new InvalidDatetimeError('datetime so close to year zero not allowed');
|
|
28
|
+
}
|
|
29
|
+
};
|
|
30
|
+
exports.ensureValidDatetime = ensureValidDatetime;
|
|
31
|
+
/* Same logic as ensureValidDatetime(), but returns a boolean instead of throwing an exception.
|
|
32
|
+
*/
|
|
33
|
+
const isValidDatetime = (dtStr) => {
|
|
34
|
+
try {
|
|
35
|
+
(0, exports.ensureValidDatetime)(dtStr);
|
|
36
|
+
}
|
|
37
|
+
catch (err) {
|
|
38
|
+
if (err instanceof InvalidDatetimeError) {
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
throw err;
|
|
42
|
+
}
|
|
43
|
+
return true;
|
|
44
|
+
};
|
|
45
|
+
exports.isValidDatetime = isValidDatetime;
|
|
46
|
+
/* Takes a flexible datetime string and normalizes representation.
|
|
47
|
+
*
|
|
48
|
+
* This function will work with any valid atproto datetime (eg, anything which isValidDatetime() is true for). It *additionally* is more flexible about accepting datetimes that don't comply to RFC 3339, or are missing timezone information, and normalizing them to a valid datetime.
|
|
49
|
+
*
|
|
50
|
+
* One use-case is a consistent, sortable string. Another is to work with older invalid createdAt datetimes.
|
|
51
|
+
*
|
|
52
|
+
* Successful output will be a valid atproto datetime with millisecond precision (3 sub-second digits) and UTC timezone with trailing 'Z' syntax. Throws `InvalidDatetimeError` if the input string could not be parsed as a datetime, even with permissive parsing.
|
|
53
|
+
*
|
|
54
|
+
* Expected output format: YYYY-MM-DDTHH:mm:ss.sssZ
|
|
55
|
+
*/
|
|
56
|
+
const normalizeDatetime = (dtStr) => {
|
|
57
|
+
if ((0, exports.isValidDatetime)(dtStr)) {
|
|
58
|
+
const outStr = new Date(dtStr).toISOString();
|
|
59
|
+
if ((0, exports.isValidDatetime)(outStr)) {
|
|
60
|
+
return outStr;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
// check if this permissive datetime is missing a timezone
|
|
64
|
+
if (!/.*(([+-]\d\d:?\d\d)|[a-zA-Z])$/.test(dtStr)) {
|
|
65
|
+
const date = new Date(dtStr + 'Z');
|
|
66
|
+
if (!isNaN(date.getTime())) {
|
|
67
|
+
const tzStr = date.toISOString();
|
|
68
|
+
if ((0, exports.isValidDatetime)(tzStr)) {
|
|
69
|
+
return tzStr;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
// finally try parsing as simple datetime
|
|
74
|
+
const date = new Date(dtStr);
|
|
75
|
+
if (isNaN(date.getTime())) {
|
|
76
|
+
throw new InvalidDatetimeError('datetime did not parse as any timestamp format');
|
|
77
|
+
}
|
|
78
|
+
const isoStr = date.toISOString();
|
|
79
|
+
if ((0, exports.isValidDatetime)(isoStr)) {
|
|
80
|
+
return isoStr;
|
|
81
|
+
}
|
|
82
|
+
else {
|
|
83
|
+
throw new InvalidDatetimeError('datetime normalized to invalid timestamp string');
|
|
84
|
+
}
|
|
85
|
+
};
|
|
86
|
+
exports.normalizeDatetime = normalizeDatetime;
|
|
87
|
+
/* Variant of normalizeDatetime() which always returns a valid datetime strings.
|
|
88
|
+
*
|
|
89
|
+
* If a InvalidDatetimeError is encountered, returns the UNIX epoch time as a UTC datetime (1970-01-01T00:00:00.000Z).
|
|
90
|
+
*/
|
|
91
|
+
const normalizeDatetimeAlways = (dtStr) => {
|
|
92
|
+
try {
|
|
93
|
+
return (0, exports.normalizeDatetime)(dtStr);
|
|
94
|
+
}
|
|
95
|
+
catch (err) {
|
|
96
|
+
if (err instanceof InvalidDatetimeError) {
|
|
97
|
+
return new Date(0).toISOString();
|
|
98
|
+
}
|
|
99
|
+
throw err;
|
|
100
|
+
}
|
|
101
|
+
};
|
|
102
|
+
exports.normalizeDatetimeAlways = normalizeDatetimeAlways;
|
|
103
|
+
/* Indicates a datetime string did not pass full atproto Lexicon datetime string format checks.
|
|
104
|
+
*/
|
|
105
|
+
class InvalidDatetimeError extends Error {
|
|
106
|
+
}
|
|
107
|
+
exports.InvalidDatetimeError = InvalidDatetimeError;
|
|
108
|
+
//# sourceMappingURL=datetime.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"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"}
|
package/dist/did.d.ts
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"did.d.ts","sourceRoot":"","sources":["../src/did.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,cAAc,QAAS,MAAM,KAAG,IA8B5C,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAS,MAAM,KAAG,IAUjD,CAAA;AAED,qBAAa,eAAgB,SAAQ,KAAK;CAAG"}
|
package/dist/did.js
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.InvalidDidError = exports.ensureValidDidRegex = exports.ensureValidDid = void 0;
|
|
4
|
+
// Human-readable constraints:
|
|
5
|
+
// - valid W3C DID (https://www.w3.org/TR/did-core/#did-syntax)
|
|
6
|
+
// - entire URI is ASCII: [a-zA-Z0-9._:%-]
|
|
7
|
+
// - always starts "did:" (lower-case)
|
|
8
|
+
// - method name is one or more lower-case letters, followed by ":"
|
|
9
|
+
// - remaining identifier can have any of the above chars, but can not end in ":"
|
|
10
|
+
// - it seems that a bunch of ":" can be included, and don't need spaces between
|
|
11
|
+
// - "%" is used only for "percent encoding" and must be followed by two hex characters (and thus can't end in "%")
|
|
12
|
+
// - query ("?") and fragment ("#") stuff is defined for "DID URIs", but not as part of identifier itself
|
|
13
|
+
// - "The current specification does not take a position on the maximum length of a DID"
|
|
14
|
+
// - in current atproto, only allowing did:plc and did:web. But not *forcing* this at lexicon layer
|
|
15
|
+
// - hard length limit of 8KBytes
|
|
16
|
+
// - not going to validate "percent encoding" here
|
|
17
|
+
const ensureValidDid = (did) => {
|
|
18
|
+
if (!did.startsWith('did:')) {
|
|
19
|
+
throw new InvalidDidError('DID requires "did:" prefix');
|
|
20
|
+
}
|
|
21
|
+
// check that all chars are boring ASCII
|
|
22
|
+
if (!/^[a-zA-Z0-9._:%-]*$/.test(did)) {
|
|
23
|
+
throw new InvalidDidError('Disallowed characters in DID (ASCII letters, digits, and a couple other characters only)');
|
|
24
|
+
}
|
|
25
|
+
const { length, 1: method } = did.split(':');
|
|
26
|
+
if (length < 3) {
|
|
27
|
+
throw new InvalidDidError('DID requires prefix, method, and method-specific content');
|
|
28
|
+
}
|
|
29
|
+
if (!/^[a-z]+$/.test(method)) {
|
|
30
|
+
throw new InvalidDidError('DID method must be lower-case letters');
|
|
31
|
+
}
|
|
32
|
+
if (did.endsWith(':') || did.endsWith('%')) {
|
|
33
|
+
throw new InvalidDidError('DID can not end with ":" or "%"');
|
|
34
|
+
}
|
|
35
|
+
if (did.length > 2 * 1024) {
|
|
36
|
+
throw new InvalidDidError('DID is too long (2048 chars max)');
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
exports.ensureValidDid = ensureValidDid;
|
|
40
|
+
const ensureValidDidRegex = (did) => {
|
|
41
|
+
// simple regex to enforce most constraints via just regex and length.
|
|
42
|
+
// hand wrote this regex based on above constraints
|
|
43
|
+
if (!/^did:[a-z]+:[a-zA-Z0-9._:%-]*[a-zA-Z0-9._-]$/.test(did)) {
|
|
44
|
+
throw new InvalidDidError("DID didn't validate via regex");
|
|
45
|
+
}
|
|
46
|
+
if (did.length > 2 * 1024) {
|
|
47
|
+
throw new InvalidDidError('DID is too long (2048 chars max)');
|
|
48
|
+
}
|
|
49
|
+
};
|
|
50
|
+
exports.ensureValidDidRegex = ensureValidDidRegex;
|
|
51
|
+
class InvalidDidError extends Error {
|
|
52
|
+
}
|
|
53
|
+
exports.InvalidDidError = InvalidDidError;
|
|
54
|
+
//# sourceMappingURL=did.js.map
|
package/dist/did.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"did.js","sourceRoot":"","sources":["../src/did.ts"],"names":[],"mappings":";;;AAAA,8BAA8B;AAC9B,iEAAiE;AACjE,+CAA+C;AAC/C,2CAA2C;AAC3C,wEAAwE;AACxE,sFAAsF;AACtF,qFAAqF;AACrF,wHAAwH;AACxH,8GAA8G;AAC9G,6FAA6F;AAC7F,qGAAqG;AACrG,mCAAmC;AACnC,oDAAoD;AAC7C,MAAM,cAAc,GAAG,CAAC,GAAW,EAAQ,EAAE;IAClD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,4BAA4B,CAAC,CAAA;IACzD,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,eAAe,CACvB,0FAA0F,CAC3F,CAAA;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CACvB,0DAA0D,CAC3D,CAAA;IACH,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,eAAe,CAAC,uCAAuC,CAAC,CAAA;IACpE,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,eAAe,CAAC,iCAAiC,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAA;IAC/D,CAAC;AACH,CAAC,CAAA;AA9BY,QAAA,cAAc,kBA8B1B;AAEM,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAQ,EAAE;IACvD,sEAAsE;IACtE,mDAAmD;IACnD,IAAI,CAAC,8CAA8C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,eAAe,CAAC,+BAA+B,CAAC,CAAA;IAC5D,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAA;IAC/D,CAAC;AACH,CAAC,CAAA;AAVY,QAAA,mBAAmB,uBAU/B;AAED,MAAa,eAAgB,SAAQ,KAAK;CAAG;AAA7C,0CAA6C"}
|
package/dist/handle.d.ts
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../src/handle.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,mBAAmB,CAAA;AAM9C,eAAO,MAAM,eAAe,UAY3B,CAAA;AAqBD,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,IAkClD,CAAA;AAGD,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,IAWvD,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,MAAM,KAAG,MAEhD,CAAA;AAED,eAAO,MAAM,6BAA6B,WAAY,MAAM,KAAG,MAI9D,CAAA;AAED,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,OAW9C,CAAA;AAED,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,OAE3C,CAAA;AAED,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAChD,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AACjD,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AACpD,qBAAa,qBAAsB,SAAQ,KAAK;CAAG"}
|