@atproto-labs/xrpc-utils 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @atproto-labs/xrpc-utils
+
+## 0.0.1
+
+### Patch Changes
+
+- [#3177](https://github.com/bluesky-social/atproto/pull/3177) [`72eba67af`](https://github.com/bluesky-social/atproto/commit/72eba67af1af8320b5400bcb9319d5c3c8407d99) Thanks [@matthieusieben](https://github.com/matthieusieben)! - New utility package to work with xrpc-server
+
+- Updated dependencies []:
+  - @atproto/xrpc-server@0.7.5
+  - @atproto/xrpc@0.6.6

package/LICENSE.txt

@@ -0,0 +1,7 @@
+Dual MIT/Apache-2.0 License
+
+Copyright (c) 2022-2024 Bluesky PBC, and Contributors
+
+Except as otherwise noted in individual files, this software is licensed under the MIT license (<http://opensource.org/licenses/MIT>), or the Apache License, Version 2.0 (<http://www.apache.org/licenses/LICENSE-2.0>).
+
+Downstream projects and end users may chose either license individually, or both together, at their discretion. The motivation for this dual-licensing is the additional software patent assurance provided by Apache 2.0.

package/dist/accept.d.ts

@@ -0,0 +1,13 @@
+export type AcceptFlags = {
+    q: number;
+};
+export type Accept = [name: string, flags: AcceptFlags];
+export declare const ACCEPT_ENCODING_COMPRESSED: readonly [Accept, ...Accept[]];
+export declare const ACCEPT_ENCODING_UNCOMPRESSED: readonly [Accept, ...Accept[]];
+export declare function buildProxiedContentEncoding(acceptHeader: undefined | string | string[], preferCompressed: boolean): string;
+export declare function negotiateContentEncoding(acceptHeader: undefined | string | string[], preferences: readonly Accept[]): string;
+/**
+ * @see {@link https://developer.mozilla.org/en-US/docs/Glossary/Quality_values}
+ */
+export declare function formatAcceptHeader(accept: readonly [Accept, ...Accept[]]): string;
+//# sourceMappingURL=accept.d.ts.map

package/dist/accept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept.d.ts","sourceRoot":"","sources":["../src/accept.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACvC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;AAEvD,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAKrE,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAKvE,CAAA;AAMD,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,EAC3C,gBAAgB,EAAE,OAAO,GACxB,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,EAC3C,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,CAoCR;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACrC,MAAM,CAER"}

package/dist/accept.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCEPT_ENCODING_UNCOMPRESSED = exports.ACCEPT_ENCODING_COMPRESSED = void 0;
+exports.buildProxiedContentEncoding = buildProxiedContentEncoding;
+exports.negotiateContentEncoding = negotiateContentEncoding;
+exports.formatAcceptHeader = formatAcceptHeader;
+const xrpc_1 = require("@atproto/xrpc");
+const xrpc_server_1 = require("@atproto/xrpc-server");
+exports.ACCEPT_ENCODING_COMPRESSED = [
+    ['gzip', { q: 1.0 }],
+    ['deflate', { q: 0.9 }],
+    ['br', { q: 0.8 }],
+    ['identity', { q: 0.1 }],
+];
+exports.ACCEPT_ENCODING_UNCOMPRESSED = [
+    ['identity', { q: 1.0 }],
+    ['gzip', { q: 0.3 }],
+    ['deflate', { q: 0.2 }],
+    ['br', { q: 0.1 }],
+];
+// accept-encoding defaults to "identity with lowest priority"
+const ACCEPT_ENC_DEFAULT = ['identity', { q: 0.001 }];
+const ACCEPT_FORBID_STAR = ['*', { q: 0 }];
+function buildProxiedContentEncoding(acceptHeader, preferCompressed) {
+    return negotiateContentEncoding(acceptHeader, preferCompressed
+        ? exports.ACCEPT_ENCODING_COMPRESSED
+        : exports.ACCEPT_ENCODING_UNCOMPRESSED);
+}
+function negotiateContentEncoding(acceptHeader, preferences) {
+    const acceptMap = Object.fromEntries(parseAcceptEncoding(acceptHeader));
+    // Make sure the default (identity) is covered by the preferences
+    if (!preferences.some(coversIdentityAccept)) {
+        preferences = [...preferences, ACCEPT_ENC_DEFAULT];
+    }
+    const common = preferences.filter(([name]) => {
+        const acceptQ = (acceptMap[name] ?? acceptMap['*'])?.q;
+        // Per HTTP/1.1, "identity" is always acceptable unless explicitly rejected
+        if (name === 'identity') {
+            return acceptQ == null || acceptQ > 0;
+        }
+        else {
+            return acceptQ != null && acceptQ > 0;
+        }
+    });
+    // Since "identity" was present in the preferences, a missing "identity" in
+    // the common array means that the client explicitly rejected it. Let's reflect
+    // this by adding it to the common array.
+    if (!common.some(coversIdentityAccept)) {
+        common.push(ACCEPT_FORBID_STAR);
+    }
+    // If no common encodings are acceptable, throw a 406 Not Acceptable error
+    if (!common.some(isAllowedAccept)) {
+        throw new xrpc_server_1.XRPCError(xrpc_1.ResponseType.NotAcceptable, 'this service does not support any of the requested encodings');
+    }
+    return formatAcceptHeader(common);
+}
+function coversIdentityAccept([name]) {
+    return name === 'identity' || name === '*';
+}
+function isAllowedAccept([, flags]) {
+    return flags.q > 0;
+}
+/**
+ * @see {@link https://developer.mozilla.org/en-US/docs/Glossary/Quality_values}
+ */
+function formatAcceptHeader(accept) {
+    return accept.map(formatAcceptPart).join(',');
+}
+function formatAcceptPart([name, flags]) {
+    return `${name};q=${flags.q}`;
+}
+function parseAcceptEncoding(acceptEncodings) {
+    if (!acceptEncodings?.length)
+        return [];
+    return Array.isArray(acceptEncodings)
+        ? acceptEncodings.flatMap(parseAcceptEncoding)
+        : acceptEncodings.split(',').map(parseAcceptEncodingDefinition);
+}
+function parseAcceptEncodingDefinition(def) {
+    const { length, 0: encoding, 1: params } = def.trim().split(';', 3);
+    if (length > 2) {
+        throw new xrpc_server_1.InvalidRequestError(`Invalid accept-encoding: "${def}"`);
+    }
+    if (!encoding || encoding.includes('=')) {
+        throw new xrpc_server_1.InvalidRequestError(`Invalid accept-encoding: "${def}"`);
+    }
+    const flags = { q: 1 };
+    if (length === 2) {
+        const { length, 0: key, 1: value } = params.split('=', 3);
+        if (length !== 2) {
+            throw new xrpc_server_1.InvalidRequestError(`Invalid accept-encoding: "${def}"`);
+        }
+        if (key === 'q' || key === 'Q') {
+            const q = parseFloat(value);
+            if (q === 0 || (Number.isFinite(q) && q <= 1 && q >= 0.001)) {
+                flags.q = q;
+            }
+            else {
+                throw new xrpc_server_1.InvalidRequestError(`Invalid accept-encoding: "${def}"`);
+            }
+        }
+        else {
+            throw new xrpc_server_1.InvalidRequestError(`Invalid accept-encoding: "${def}"`);
+        }
+    }
+    return [encoding.toLowerCase(), flags];
+}
+//# sourceMappingURL=accept.js.map

package/dist/accept.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './accept.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./accept.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA2B"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@atproto-labs/xrpc-utils",
+  "version": "0.0.1",
+  "license": "MIT",
+  "description": "XRPC server utilities for Node.JS",
+  "keywords": [
+    "atproto",
+    "node",
+    "xrpc",
+    "server",
+    "utilities",
+    "content",
+    "negotiation"
+  ],
+  "homepage": "https://atproto.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bluesky-social/atproto",
+    "directory": "packages/internal/xrpc-utils"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./accept": {
+      "types": "./dist/accept.d.ts",
+      "default": "./dist/accept.js"
+    }
+  },
+  "dependencies": {
+    "@atproto/xrpc": "^0.6.6",
+    "@atproto/xrpc-server": "^0.7.5"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.json"
+  }
+}

package/src/accept.ts

@@ -0,0 +1,143 @@
+import { ResponseType } from '@atproto/xrpc'
+import {
+  InvalidRequestError,
+  XRPCError as XRPCServerError,
+} from '@atproto/xrpc-server'
+
+export type AcceptFlags = { q: number }
+export type Accept = [name: string, flags: AcceptFlags]
+
+export const ACCEPT_ENCODING_COMPRESSED: readonly [Accept, ...Accept[]] = [
+  ['gzip', { q: 1.0 }],
+  ['deflate', { q: 0.9 }],
+  ['br', { q: 0.8 }],
+  ['identity', { q: 0.1 }],
+]
+
+export const ACCEPT_ENCODING_UNCOMPRESSED: readonly [Accept, ...Accept[]] = [
+  ['identity', { q: 1.0 }],
+  ['gzip', { q: 0.3 }],
+  ['deflate', { q: 0.2 }],
+  ['br', { q: 0.1 }],
+]
+
+// accept-encoding defaults to "identity with lowest priority"
+const ACCEPT_ENC_DEFAULT = ['identity', { q: 0.001 }] as const satisfies Accept
+const ACCEPT_FORBID_STAR = ['*', { q: 0 }] as const satisfies Accept
+
+export function buildProxiedContentEncoding(
+  acceptHeader: undefined | string | string[],
+  preferCompressed: boolean,
+): string {
+  return negotiateContentEncoding(
+    acceptHeader,
+    preferCompressed
+      ? ACCEPT_ENCODING_COMPRESSED
+      : ACCEPT_ENCODING_UNCOMPRESSED,
+  )
+}
+
+export function negotiateContentEncoding(
+  acceptHeader: undefined | string | string[],
+  preferences: readonly Accept[],
+): string {
+  const acceptMap = Object.fromEntries<undefined | AcceptFlags>(
+    parseAcceptEncoding(acceptHeader),
+  )
+
+  // Make sure the default (identity) is covered by the preferences
+  if (!preferences.some(coversIdentityAccept)) {
+    preferences = [...preferences, ACCEPT_ENC_DEFAULT]
+  }
+
+  const common = preferences.filter(([name]) => {
+    const acceptQ = (acceptMap[name] ?? acceptMap['*'])?.q
+    // Per HTTP/1.1, "identity" is always acceptable unless explicitly rejected
+    if (name === 'identity') {
+      return acceptQ == null || acceptQ > 0
+    } else {
+      return acceptQ != null && acceptQ > 0
+    }
+  })
+
+  // Since "identity" was present in the preferences, a missing "identity" in
+  // the common array means that the client explicitly rejected it. Let's reflect
+  // this by adding it to the common array.
+  if (!common.some(coversIdentityAccept)) {
+    common.push(ACCEPT_FORBID_STAR)
+  }
+
+  // If no common encodings are acceptable, throw a 406 Not Acceptable error
+  if (!common.some(isAllowedAccept)) {
+    throw new XRPCServerError(
+      ResponseType.NotAcceptable,
+      'this service does not support any of the requested encodings',
+    )
+  }
+
+  return formatAcceptHeader(common as [Accept, ...Accept[]])
+}
+
+function coversIdentityAccept([name]: Accept): boolean {
+  return name === 'identity' || name === '*'
+}
+
+function isAllowedAccept([, flags]: Accept): boolean {
+  return flags.q > 0
+}
+
+/**
+ * @see {@link https://developer.mozilla.org/en-US/docs/Glossary/Quality_values}
+ */
+export function formatAcceptHeader(
+  accept: readonly [Accept, ...Accept[]],
+): string {
+  return accept.map(formatAcceptPart).join(',')
+}
+
+function formatAcceptPart([name, flags]: Accept): string {
+  return `${name};q=${flags.q}`
+}
+
+function parseAcceptEncoding(
+  acceptEncodings: undefined | string | string[],
+): Accept[] {
+  if (!acceptEncodings?.length) return []
+
+  return Array.isArray(acceptEncodings)
+    ? acceptEncodings.flatMap(parseAcceptEncoding)
+    : acceptEncodings.split(',').map(parseAcceptEncodingDefinition)
+}
+
+function parseAcceptEncodingDefinition(def: string): Accept {
+  const { length, 0: encoding, 1: params } = def.trim().split(';', 3)
+
+  if (length > 2) {
+    throw new InvalidRequestError(`Invalid accept-encoding: "${def}"`)
+  }
+
+  if (!encoding || encoding.includes('=')) {
+    throw new InvalidRequestError(`Invalid accept-encoding: "${def}"`)
+  }
+
+  const flags = { q: 1 }
+  if (length === 2) {
+    const { length, 0: key, 1: value } = params.split('=', 3)
+    if (length !== 2) {
+      throw new InvalidRequestError(`Invalid accept-encoding: "${def}"`)
+    }
+
+    if (key === 'q' || key === 'Q') {
+      const q = parseFloat(value)
+      if (q === 0 || (Number.isFinite(q) && q <= 1 && q >= 0.001)) {
+        flags.q = q
+      } else {
+        throw new InvalidRequestError(`Invalid accept-encoding: "${def}"`)
+      }
+    } else {
+      throw new InvalidRequestError(`Invalid accept-encoding: "${def}"`)
+    }
+  }
+
+  return [encoding.toLowerCase(), flags]
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './accept.js'

package/tsconfig.build.json

@@ -0,0 +1,8 @@
+{
+  "extends": ["../../../tsconfig/node.json"],
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}

package/tsconfig.build.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/accept.ts","./src/index.ts"],"version":"5.6.3"}

package/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "include": [],
+  "references": [{ "path": "./tsconfig.build.json" }]
+}