@atproto/oauth-scopes 0.0.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @atproto/oauth-scopes
 
+## 0.2.0
+
+### Minor Changes
+
+- [#4149](https://github.com/bluesky-social/atproto/pull/4149) [`8914f9abd`](https://github.com/bluesky-social/atproto/commit/8914f9abde2059c551d7e4c8d104227986098b82) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Method `authenticateRequest` now returns `SignedTokenPayload`
+
+### Patch Changes
+
+- [#4149](https://github.com/bluesky-social/atproto/pull/4149) [`8914f9abd`](https://github.com/bluesky-social/atproto/commit/8914f9abde2059c551d7e4c8d104227986098b82) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add scope normalization utility
+
+- Updated dependencies []:
+  - @atproto/lexicon@0.5.1
+
+## 0.1.0
+
+### Minor Changes
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Rework scope parsing utilities to work with Lexicon defined permissions
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Use strict NSID validation. repo & rpc scopes with invalid NSIDs will be rejected.
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Rename `PermissionSet` to `ScopePermissions`
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Renaming of "resource" concept to better reflect the fact that not all oauth scope values are about resources
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Enforce proper formatting of audience (atproto supported did + fragment part)
+
+### Patch Changes
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Ignore empty string when building a `ScopePermissions`
+
+- [#4108](https://github.com/bluesky-social/atproto/pull/4108) [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Export constants and type assertion utilities
+
+- Updated dependencies [[`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d), [`f9dc9aa4c`](https://github.com/bluesky-social/atproto/commit/f9dc9aa4c9eaf2f82d140fbf011a9015e7f1a00d)]:
+  - @atproto/lexicon@0.5.0
+  - @atproto/syntax@0.4.1
+  - @atproto/did@0.2.0
+
 ## 0.0.2
 
 ### Patch Changes

package/dist/atproto-oauth-scope.d.ts

@@ -0,0 +1,17 @@
+import { ScopeStringFor, isScopeStringFor } from './lib/syntax.js';
+export { type ScopeStringFor, isScopeStringFor };
+export declare const STATIC_SCOPE_VALUES: readonly ["atproto", "transition:email", "transition:generic", "transition:chat.bsky"];
+export type StaticScopeValue = (typeof STATIC_SCOPE_VALUES)[number];
+export declare function isStaticScopeValue(value: string): value is StaticScopeValue;
+export type AtprotoOauthScope = StaticScopeValue | ScopeStringFor<'account'> | ScopeStringFor<'blob'> | ScopeStringFor<'identity'> | ScopeStringFor<'include'> | ScopeStringFor<'repo'> | ScopeStringFor<'rpc'>;
+/**
+ * @note This function does not only verify the scope string format (with
+ * {@link isScopeStringFor}), but also checks if the provided parameters are
+ * valid according to the respective scope syntax definition. This allows
+ * excluding scopes that cannot be fully interpreted by the current version of
+ * the code.
+ */
+export declare function isAtprotoOauthScope(value: string): value is AtprotoOauthScope;
+export declare function normalizeAtprotoOauthScope(scope: string): string;
+export declare function normalizeAtprotoOauthScopeValue(value: string): AtprotoOauthScope | null;
+//# sourceMappingURL=atproto-oauth-scope.d.ts.map

package/dist/atproto-oauth-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atproto-oauth-scope.d.ts","sourceRoot":"","sources":["../src/atproto-oauth-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AASlE,OAAO,EAAE,KAAK,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAEhD,eAAO,MAAM,mBAAmB,wFAKrB,CAAA;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AACnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,cAAc,CAAC,SAAS,CAAC,GACzB,cAAc,CAAC,MAAM,CAAC,GACtB,cAAc,CAAC,UAAU,CAAC,GAC1B,cAAc,CAAC,SAAS,CAAC,GACzB,cAAc,CAAC,MAAM,CAAC,GACtB,cAAc,CAAC,KAAK,CAAC,CAAA;AAEzB;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAU7E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,UAOvD;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GACZ,iBAAiB,GAAG,IAAI,CAgB1B"}

package/dist/atproto-oauth-scope.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATIC_SCOPE_VALUES = exports.isScopeStringFor = void 0;
+exports.isStaticScopeValue = isStaticScopeValue;
+exports.isAtprotoOauthScope = isAtprotoOauthScope;
+exports.normalizeAtprotoOauthScope = normalizeAtprotoOauthScope;
+exports.normalizeAtprotoOauthScopeValue = normalizeAtprotoOauthScopeValue;
+const syntax_js_1 = require("./lib/syntax.js");
+Object.defineProperty(exports, "isScopeStringFor", { enumerable: true, get: function () { return syntax_js_1.isScopeStringFor; } });
+const util_js_1 = require("./lib/util.js");
+const account_permission_js_1 = require("./scopes/account-permission.js");
+const blob_permission_js_1 = require("./scopes/blob-permission.js");
+const identity_permission_js_1 = require("./scopes/identity-permission.js");
+const include_scope_js_1 = require("./scopes/include-scope.js");
+const repo_permission_js_1 = require("./scopes/repo-permission.js");
+const rpc_permission_js_1 = require("./scopes/rpc-permission.js");
+exports.STATIC_SCOPE_VALUES = Object.freeze([
+    'atproto',
+    'transition:email',
+    'transition:generic',
+    'transition:chat.bsky',
+]);
+function isStaticScopeValue(value) {
+    return exports.STATIC_SCOPE_VALUES.includes(value);
+}
+/**
+ * @note This function does not only verify the scope string format (with
+ * {@link isScopeStringFor}), but also checks if the provided parameters are
+ * valid according to the respective scope syntax definition. This allows
+ * excluding scopes that cannot be fully interpreted by the current version of
+ * the code.
+ */
+function isAtprotoOauthScope(value) {
+    return (isStaticScopeValue(value) ||
+        account_permission_js_1.AccountPermission.fromString(value) != null ||
+        blob_permission_js_1.BlobPermission.fromString(value) != null ||
+        identity_permission_js_1.IdentityPermission.fromString(value) != null ||
+        include_scope_js_1.IncludeScope.fromString(value) != null ||
+        repo_permission_js_1.RepoPermission.fromString(value) != null ||
+        rpc_permission_js_1.RpcPermission.fromString(value) != null);
+}
+function normalizeAtprotoOauthScope(scope) {
+    return scope
+        .split(' ')
+        .map(normalizeAtprotoOauthScopeValue)
+        .filter(util_js_1.isNonNullable)
+        .sort()
+        .join(' ');
+}
+function normalizeAtprotoOauthScopeValue(value) {
+    if (isStaticScopeValue(value))
+        return value;
+    for (const Scope of [
+        account_permission_js_1.AccountPermission,
+        blob_permission_js_1.BlobPermission,
+        identity_permission_js_1.IdentityPermission,
+        include_scope_js_1.IncludeScope,
+        repo_permission_js_1.RepoPermission,
+        rpc_permission_js_1.RpcPermission,
+    ]) {
+        const parsed = Scope.fromString(value);
+        if (parsed)
+            return parsed.toString();
+    }
+    return null;
+}
+//# sourceMappingURL=atproto-oauth-scope.js.map

package/dist/atproto-oauth-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atproto-oauth-scope.js","sourceRoot":"","sources":["../src/atproto-oauth-scope.ts"],"names":[],"mappings":";;;AAmBA,gDAEC;AAkBD,kDAUC;AAED,gEAOC;AAED,0EAkBC;AA9ED,+CAAkE;AASpC,iGATL,4BAAgB,OASK;AAR9C,2CAA6C;AAC7C,0EAAkE;AAClE,oEAA4D;AAC5D,4EAAoE;AACpE,gEAAwD;AACxD,oEAA4D;AAC5D,kEAA0D;AAI7C,QAAA,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,SAAS;IACT,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;CACd,CAAC,CAAA;AAGX,SAAgB,kBAAkB,CAAC,KAAa;IAC9C,OAAQ,2BAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACnE,CAAC;AAWD;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,CACL,kBAAkB,CAAC,KAAK,CAAC;QACzB,yCAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI;QAC3C,mCAAc,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI;QACxC,2CAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI;QAC5C,+BAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI;QACtC,mCAAc,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI;QACxC,iCAAa,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CACxC,CAAA;AACH,CAAC;AAED,SAAgB,0BAA0B,CAAC,KAAa;IACtD,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,+BAA+B,CAAC;SACpC,MAAM,CAAC,uBAAa,CAAC;SACrB,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,SAAgB,+BAA+B,CAC7C,KAAa;IAEb,IAAI,kBAAkB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAE3C,KAAK,MAAM,KAAK,IAAI;QAClB,yCAAiB;QACjB,mCAAc;QACd,2CAAkB;QAClB,+BAAY;QACZ,mCAAc;QACd,iCAAa;KACd,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACtC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;IACtC,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -1,16 +1,12 @@
+export * from './atproto-oauth-scope.js';
 export * from './scope-missing-error.js';
-export * from './permission-set.js';
-export * from './permission-set-transition.js';
+export * from './scope-permissions-transition.js';
+export * from './scope-permissions.js';
 export * from './scopes-set.js';
-export * from './parser.js';
-export * from './syntax.js';
-export * from './utilities.js';
-export * from './resources/account-scope.js';
-export * from './resources/blob-scope.js';
-export * from './resources/identity-scope.js';
-export * from './resources/repo-scope.js';
-export * from './resources/rpc-scope.js';
-export * from './lib/mime.js';
-export * from './lib/did.js';
-export * from './lib/nsid.js';
+export * from './scopes/account-permission.js';
+export * from './scopes/blob-permission.js';
+export * from './scopes/identity-permission.js';
+export * from './scopes/include-scope.js';
+export * from './scopes/repo-permission.js';
+export * from './scopes/rpc-permission.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAE9B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AAExC,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AAExC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA"}

package/dist/index.js

@@ -14,19 +14,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./atproto-oauth-scope.js"), exports);
 __exportStar(require("./scope-missing-error.js"), exports);
-__exportStar(require("./permission-set.js"), exports);
-__exportStar(require("./permission-set-transition.js"), exports);
+__exportStar(require("./scope-permissions-transition.js"), exports);
+__exportStar(require("./scope-permissions.js"), exports);
 __exportStar(require("./scopes-set.js"), exports);
-__exportStar(require("./parser.js"), exports);
-__exportStar(require("./syntax.js"), exports);
-__exportStar(require("./utilities.js"), exports);
-__exportStar(require("./resources/account-scope.js"), exports);
-__exportStar(require("./resources/blob-scope.js"), exports);
-__exportStar(require("./resources/identity-scope.js"), exports);
-__exportStar(require("./resources/repo-scope.js"), exports);
-__exportStar(require("./resources/rpc-scope.js"), exports);
-__exportStar(require("./lib/mime.js"), exports);
-__exportStar(require("./lib/did.js"), exports);
-__exportStar(require("./lib/nsid.js"), exports);
+__exportStar(require("./scopes/account-permission.js"), exports);
+__exportStar(require("./scopes/blob-permission.js"), exports);
+__exportStar(require("./scopes/identity-permission.js"), exports);
+__exportStar(require("./scopes/include-scope.js"), exports);
+__exportStar(require("./scopes/repo-permission.js"), exports);
+__exportStar(require("./scopes/rpc-permission.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC;AACxC,sDAAmC;AACnC,iEAA8C;AAC9C,kDAA+B;AAC/B,8CAA2B;AAC3B,8CAA2B;AAC3B,iDAA8B;AAE9B,+DAA4C;AAC5C,4DAAyC;AACzC,gEAA6C;AAC7C,4DAAyC;AACzC,2DAAwC;AAExC,gDAA6B;AAC7B,+CAA4B;AAC5B,gDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAwC;AAExC,2DAAwC;AACxC,oEAAiD;AACjD,yDAAsC;AACtC,kDAA+B;AAE/B,iEAA8C;AAC9C,8DAA2C;AAC3C,kEAA+C;AAC/C,4DAAyC;AACzC,8DAA2C;AAC3C,6DAA0C"}

package/dist/lib/lexicon.d.ts

@@ -0,0 +1,2 @@
+export type { LexPermission, LexPermissionSet } from '@atproto/lexicon';
+//# sourceMappingURL=lexicon.d.ts.map

package/dist/lib/lexicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexicon.d.ts","sourceRoot":"","sources":["../../src/lib/lexicon.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/lib/lexicon.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lexicon.js.map

package/dist/lib/lexicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexicon.js","sourceRoot":"","sources":["../../src/lib/lexicon.ts"],"names":[],"mappings":""}

package/dist/lib/mime.d.ts

@@ -1,7 +1,7 @@
 export type Mime = `${string}/${string}`;
 export declare function isMime(value: string): value is Mime;
 export type Accept = '*/*' | `${string}/*` | Mime;
-export declare function isAccept(value: string): value is Accept;
+export declare function isAccept(value: unknown): value is Accept;
 export declare function matchesAccept(accept: Accept, mime: string): boolean;
 export declare function matchesAnyAccept(acceptable: Iterable<Accept>, mime: string): boolean;
 //# sourceMappingURL=mime.d.ts.map

package/dist/lib/mime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/lib/mime.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAExC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEnD;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI,CAAA;AAEjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAIvD;AAiBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAmBD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAET"}
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/lib/mime.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAExC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEnD;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI,CAAA;AAEjD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKxD;AAiBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAmBD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAET"}

package/dist/lib/mime.js

@@ -23,6 +23,8 @@ function isMime(value) {
     return isStringSlashString(value) && !value.includes('*');
 }
 function isAccept(value) {
+    if (typeof value !== 'string')
+        return false;
     if (value === '*/*')
         return true; // Fast path for the most common case
     if (!isStringSlashString(value))

package/dist/lib/mime.js.map

@@ -1 +1 @@
-{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../src/lib/mime.ts"],"names":[],"mappings":";AAAA,yEAAyE;;AAgBzE,wBAEC;AAID,4BAIC;AAiBD,sCAEC;AAmBD,4CAKC;AAnED,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAErC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,gBAAgB;IACpD,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,mCAAmC;IACtE,IAAI,UAAU,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,mCAAmC;IACrF,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,sBAAsB;IAC5E,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,yBAAyB;IAE/D,OAAO,IAAI,CAAA;AACb,CAAC;AAID,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC3D,CAAC;AAID,SAAgB,QAAQ,CAAC,KAAa;IACpC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA,CAAC,qCAAqC;IACtE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,IAAU;IACrD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,MAAM,KAAK,IAAI,CAAA;AACxB,CAAC;AAED,SAAgB,aAAa,CAAC,MAAc,EAAE,IAAY;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAC7B,UAA4B,EAC5B,IAAU;IAEV,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAgB,gBAAgB,CAC9B,UAA4B,EAC5B,IAAY;IAEZ,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACjE,CAAC"}
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../src/lib/mime.ts"],"names":[],"mappings":";AAAA,yEAAyE;;AAgBzE,wBAEC;AAID,4BAKC;AAiBD,sCAEC;AAmBD,4CAKC;AApED,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAErC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,gBAAgB;IACpD,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,mCAAmC;IACtE,IAAI,UAAU,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,mCAAmC;IACrF,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,sBAAsB;IAC5E,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,yBAAyB;IAE/D,OAAO,IAAI,CAAA;AACb,CAAC;AAID,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC3D,CAAC;AAID,SAAgB,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA,CAAC,qCAAqC;IACtE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,IAAU;IACrD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,MAAM,KAAK,IAAI,CAAA;AACxB,CAAC;AAED,SAAgB,aAAa,CAAC,MAAc,EAAE,IAAY;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAC1D,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAC7B,UAA4B,EAC5B,IAAU;IAEV,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAgB,gBAAgB,CAC9B,UAA4B,EAC5B,IAAY;IAEZ,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACjE,CAAC"}

package/dist/lib/nsid.d.ts

@@ -1,3 +1,3 @@
-export type NSID = `${string}.${string}`;
-export declare const isNSID: (value: string) => value is NSID;
+export type Nsid = `${string}.${string}.${string}`;
+export declare const isNsid: (v: unknown) => v is Nsid;
 //# sourceMappingURL=nsid.d.ts.map

package/dist/lib/nsid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nsid.d.ts","sourceRoot":"","sources":["../../src/lib/nsid.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AACxC,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,IAI1B,CAAA"}
+{"version":3,"file":"nsid.d.ts","sourceRoot":"","sources":["../../src/lib/nsid.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA;AAClD,eAAO,MAAM,MAAM,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,IACA,CAAA"}

package/dist/lib/nsid.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isNSID = void 0;
-const isNSID = (value) => value.includes('.') &&
-    !value.includes(' ') &&
-    !value.startsWith('.') &&
-    !value.endsWith('.');
-exports.isNSID = isNSID;
+exports.isNsid = void 0;
+const syntax_1 = require("@atproto/syntax");
+const isNsid = (v) => typeof v === 'string' && (0, syntax_1.isValidNsid)(v);
+exports.isNsid = isNsid;
 //# sourceMappingURL=nsid.js.map

package/dist/lib/nsid.js.map

@@ -1 +1 @@
-{"version":3,"file":"nsid.js","sourceRoot":"","sources":["../../src/lib/nsid.ts"],"names":[],"mappings":";;;AACO,MAAM,MAAM,GAAG,CAAC,KAAa,EAAiB,EAAE,CACrD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;IACnB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;IACpB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;IACtB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAJT,QAAA,MAAM,UAIG"}
+{"version":3,"file":"nsid.js","sourceRoot":"","sources":["../../src/lib/nsid.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAGtC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAa,EAAE,CAC9C,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAA;AAD5B,QAAA,MAAM,UACsB"}

package/dist/lib/parser.d.ts

@@ -0,0 +1,29 @@
+import { NeRoArray, ParamValue, ScopeSyntax } from './syntax.js';
+type InferParamPredicate<T extends (value: ParamValue) => boolean> = T extends ((value: ParamValue) => value is infer U extends ParamValue) ? U : ParamValue;
+type ParamsSchema = Record<string, {
+    multiple: false;
+    required: boolean;
+    default?: ParamValue;
+    normalize?: (value: ParamValue) => ParamValue;
+    validate: (value: ParamValue) => boolean;
+} | {
+    multiple: true;
+    required: boolean;
+    default?: NeRoArray<ParamValue>;
+    normalize?: (value: NeRoArray<ParamValue>) => NeRoArray<ParamValue>;
+    validate: (value: ParamValue) => boolean;
+}>;
+type InferParams<S extends ParamsSchema> = {
+    [K in keyof S]: (S[K]['required'] extends true ? never : 'default' extends keyof S[K] ? S[K]['default'] : undefined) | (S[K]['multiple'] extends true ? NeRoArray<InferParamPredicate<S[K]['validate']>> : InferParamPredicate<S[K]['validate']>);
+} & NonNullable<unknown>;
+export declare class Parser<P extends string, S extends ParamsSchema> {
+    readonly prefix: P;
+    readonly schema: S;
+    readonly positionalName?: (keyof S & string) | undefined;
+    readonly schemaKeys: ReadonlySet<keyof S & string>;
+    constructor(prefix: P, schema: S, positionalName?: (keyof S & string) | undefined);
+    format(values: InferParams<S>): import("./syntax.js").ScopeStringFor<P>;
+    parse(syntax: ScopeSyntax<P>): { [K in keyof S]: (S[K]["required"] extends true ? never : "default" extends keyof S[K] ? S[K][keyof S[K] & "default"] : undefined) | (S[K]["multiple"] extends true ? NeRoArray<InferParamPredicate<S[K]["validate"]>> : InferParamPredicate<S[K]["validate"]>); } | null;
+}
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEhE,KAAK,mBAAmB,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,IAC/D,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,KAAK,IAAI,MAAM,CAAC,SAAS,UAAU,CAAC,GAClE,CAAC,GACD,UAAU,CAAA;AAEhB,KAAK,YAAY,GAAG,MAAM,CACxB,MAAM,EACJ;IACE,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAAA;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAA;CACzC,GACD;IACE,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;IAC/B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,UAAU,CAAC,CAAA;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAA;CACzC,CACJ,CAAA;AAED,KAAK,WAAW,CAAC,CAAC,SAAS,YAAY,IAAI;KACxC,CAAC,IAAI,MAAM,CAAC,GACT,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC1B,KAAK,GACL,SAAS,SAAS,MAAM,CAAC,CAAC,CAAC,CAAC,GAC1B,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GACf,SAAS,CAAC,GAChB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAC1B,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAChD,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAC/C,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAExB,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY;aAIxC,MAAM,EAAE,CAAC;aACT,MAAM,EAAE,CAAC;aACT,cAAc,CAAC,GAAE,MAAM,CAAC,GAAG,MAAM;IALnD,SAAgB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;gBAGvC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,cAAc,CAAC,GAAE,MAAM,CAAC,GAAG,MAAM,aAAA;IAKnD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAmD7B,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAzE3B,CAAC;CAqIH"}

package/dist/lib/parser.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Parser = void 0;
+const syntax_string_js_1 = require("./syntax-string.js");
+class Parser {
+    constructor(prefix, schema, positionalName) {
+        Object.defineProperty(this, "prefix", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: prefix
+        });
+        Object.defineProperty(this, "schema", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: schema
+        });
+        Object.defineProperty(this, "positionalName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: positionalName
+        });
+        Object.defineProperty(this, "schemaKeys", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.schemaKeys = new Set(Object.keys(schema));
+    }
+    format(values) {
+        const params = new URLSearchParams();
+        let positional = undefined;
+        for (const key of this.schemaKeys) {
+            const value = values[key];
+            // Ignore undefined values
+            if (value === undefined)
+                continue;
+            const schema = this.schema[key];
+            // Normalize the value if a normalization function is provided
+            const normalized = schema.normalize
+                ? schema.normalize(value)
+                : value;
+            // Ignore values that are equal to the default value
+            if (!schema.required) {
+                if (schema.default === normalized)
+                    continue;
+                if (schema.multiple &&
+                    schema.default &&
+                    arrayParamEquals(schema.default, normalized)) {
+                    continue;
+                }
+            }
+            if (Array.isArray(normalized)) {
+                if (key === this.positionalName && normalized.length === 1) {
+                    positional = String(normalized[0]);
+                }
+                else {
+                    // remove duplicates
+                    const unique = new Set(normalized.map(String));
+                    for (const v of unique)
+                        params.append(key, v);
+                }
+            }
+            else {
+                if (key === this.positionalName) {
+                    positional = String(normalized);
+                }
+                else {
+                    params.set(key, String(normalized));
+                }
+            }
+        }
+        return new syntax_string_js_1.ScopeStringSyntax(this.prefix, positional, params).toString();
+    }
+    // @NOTE If we needed to ever have more detailed reason as to why parsing
+    // fails, this function could easily be updated to return a
+    // ValidationResult<T> type that explains the reason for failure.
+    parse(syntax) {
+        // @NOTE no need to check prefix, since the typing (P generic) already
+        // ensures it matches
+        for (const key of syntax.keys()) {
+            if (!this.schemaKeys.has(key))
+                return null;
+        }
+        const result = Object.create(null);
+        for (const key of this.schemaKeys) {
+            const definition = this.schema[key];
+            const param = definition.multiple
+                ? syntax.getMulti(key)
+                : syntax.getSingle(key);
+            if (param === null) {
+                return null; // Value is not valid
+            }
+            else if (param !== undefined) {
+                if (key === this.positionalName && syntax.positional !== undefined) {
+                    // Positional parameter cannot be used with named parameters
+                    return null;
+                }
+                if (definition.multiple) {
+                    // Empty array is not valid
+                    if (!param.length)
+                        return null;
+                    if (!param.every(definition.validate)) {
+                        return null;
+                    }
+                }
+                else {
+                    if (!definition.validate(param)) {
+                        return null;
+                    }
+                }
+                result[key] = param;
+            }
+            else if (key === this.positionalName &&
+                syntax.positional !== undefined) {
+                // No named parameters found, but there is a positional parameter
+                const { positional } = syntax;
+                if (!definition.validate(positional)) {
+                    return null;
+                }
+                result[key] = definition.multiple ? [positional] : positional;
+            }
+            else if (definition.required) {
+                return null;
+            }
+            else {
+                result[key] = definition.default;
+            }
+        }
+        return result;
+    }
+}
+exports.Parser = Parser;
+/**
+ * Two param arrays are considered equal if they contain the same values,
+ * regardless of the order and duplicates.
+ * @param a - The first array to compare.
+ * @param b - The second array to compare.
+ */
+function arrayParamEquals(a, b) {
+    for (const item of a)
+        if (!b.includes(item))
+            return false;
+    for (const item of b)
+        if (!a.includes(item))
+            return false;
+    return true;
+}
+//# sourceMappingURL=parser.js.map

package/dist/lib/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/lib/parser.ts"],"names":[],"mappings":"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"}

package/dist/lib/resource-permission.d.ts

@@ -0,0 +1,10 @@
+import { ScopeStringFor } from './syntax.js';
+import { Matchable } from './util.js';
+/**
+ * Interface destined to provide consistency across parsed permission scopes for
+ * resources (blob, repo, etc.).
+ */
+export interface ResourcePermission<R extends string, T> extends Matchable<T> {
+    toString(): ScopeStringFor<R>;
+}
+//# sourceMappingURL=resource-permission.d.ts.map

package/dist/lib/resource-permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-permission.d.ts","sourceRoot":"","sources":["../../src/lib/resource-permission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAC3E,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA;CAC9B"}

package/dist/lib/resource-permission.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resource-permission.js.map

package/dist/lib/resource-permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-permission.js","sourceRoot":"","sources":["../../src/lib/resource-permission.ts"],"names":[],"mappings":""}

package/dist/lib/syntax-lexicon.d.ts

@@ -0,0 +1,26 @@
+import { LexPermission } from './lexicon.js';
+import { ScopeSyntax } from './syntax.js';
+/**
+ * Translates a {@link LexPermission} into a {@link ScopeSyntax}.
+ */
+export declare class LexPermissionSyntax<P extends string = string> implements ScopeSyntax<P> {
+    readonly lexPermission: Readonly<LexPermission & {
+        resource: P;
+    }>;
+    constructor(lexPermission: Readonly<LexPermission & {
+        resource: P;
+    }>);
+    get prefix(): P;
+    get positional(): undefined;
+    get(key: string): string | number | boolean | (string | number | boolean)[] | undefined;
+    keys(): Generator<string, void, unknown>;
+    getSingle(key: string): string | number | boolean | null | undefined;
+    getMulti(key: string): (string | number | boolean)[] | null | undefined;
+    toJSON(): Readonly<{
+        type: "permission";
+        resource: string;
+    } & Record<string, string | number | boolean | (string | number | boolean)[] | undefined> & {
+        resource: P;
+    }>;
+}
+//# sourceMappingURL=syntax-lexicon.d.ts.map

package/dist/lib/syntax-lexicon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-lexicon.d.ts","sourceRoot":"","sources":["../../src/lib/syntax-lexicon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CACxD,YAAW,WAAW,CAAC,CAAC,CAAC;IAGvB,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,CAAC;gBAAxD,aAAa,EAAE,QAAQ,CAAC,aAAa,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,CAAC;IAGnE,IAAI,MAAM,MAET;IAED,IAAI,UAAU,cAEb;IAED,GAAG,CAAC,GAAG,EAAE,MAAM;IAWd,IAAI;IAML,SAAS,CAAC,GAAG,EAAE,MAAM;IAMrB,QAAQ,CAAC,GAAG,EAAE,MAAM;IAOpB,MAAM;;;;kBAzCyD,CAAC;;CA4CjE"}

package/dist/lib/syntax-lexicon.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LexPermissionSyntax = void 0;
+/**
+ * Translates a {@link LexPermission} into a {@link ScopeSyntax}.
+ */
+class LexPermissionSyntax {
+    constructor(lexPermission) {
+        Object.defineProperty(this, "lexPermission", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: lexPermission
+        });
+    }
+    get prefix() {
+        return this.lexPermission.resource;
+    }
+    get positional() {
+        return undefined;
+    }
+    get(key) {
+        // Ignore reserved keywords
+        if (key === 'type')
+            return undefined;
+        if (key === 'resource')
+            return undefined;
+        // Ignore inherited properties (toString(), etc.)
+        if (!Object.hasOwn(this.lexPermission, key))
+            return undefined;
+        return this.lexPermission[key];
+    }
+    *keys() {
+        for (const key of Object.keys(this.lexPermission)) {
+            if (this.get(key) !== undefined)
+                yield key;
+        }
+    }
+    getSingle(key) {
+        const value = this.get(key);
+        if (Array.isArray(value))
+            return null;
+        return value;
+    }
+    getMulti(key) {
+        const value = this.get(key);
+        if (value === undefined)
+            return undefined;
+        if (!Array.isArray(value))
+            return null;
+        return value;
+    }
+    toJSON() {
+        return this.lexPermission;
+    }
+}
+exports.LexPermissionSyntax = LexPermissionSyntax;
+//# sourceMappingURL=syntax-lexicon.js.map

package/dist/lib/syntax-lexicon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-lexicon.js","sourceRoot":"","sources":["../../src/lib/syntax-lexicon.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,mBAAmB;IAG9B,YACW,aAAwD;QAAjE;;;;mBAAS,aAAa;WAA2C;IAChE,CAAC;IAEJ,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAA;IACpC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,2BAA2B;QAC3B,IAAI,GAAG,KAAK,MAAM;YAAE,OAAO,SAAS,CAAA;QACpC,IAAI,GAAG,KAAK,UAAU;YAAE,OAAO,SAAS,CAAA;QAExC,iDAAiD;QACjD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC;YAAE,OAAO,SAAS,CAAA;QAE7D,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,CAAC,IAAI;QACH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,MAAM,GAAG,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACrC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACtC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;CACF;AAhDD,kDAgDC"}