@fedify/fedify 2.0.0-dev.1875 → 2.0.0-dev.196

package/dist/{context-DJ8aSy2Q.d.cts → context-CrB9RFy5.d.cts}

@@ -1,14 +1,11 @@
-import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-94iWEfQa.cjs";
-import { Activity, Collection, CryptographicKey, Hashtag, Link, Multikey, Object as Object$1 } from "./vocab-CeDBzu-f.cjs";
-import { Actor, Recipient } from "./actor-f2NtjyCg.cjs";
-import { HttpMessageSignaturesSpec } from "./http-M8k5mKc0.cjs";
-import { GetKeyOwnerOptions } from "./owner-B4HbyP8s.cjs";
-import { LookupObjectOptions, TraverseCollectionOptions } from "./mod-BxRCHTz-.cjs";
-import { Link as Link$1, LookupWebFingerOptions, ResourceDescriptor } from "./mod-C58MZ7Wx.cjs";
-import { KvKey, KvStore } from "./kv-Bxr0Q87_.cjs";
-import { MessageQueue } from "./mq-DcJPkXD5.cjs";
+import { GetNodeInfoOptions, JsonValue, NodeInfo } from "./client-by-PEGAJ.cjs";
+import { HttpMessageSignaturesSpec } from "./http-ClB3pLcL.cjs";
+import { GetKeyOwnerOptions } from "./owner-C-zfmVAD.cjs";
+import { KvKey, KvStore } from "./kv-B4vFhIYL.cjs";
+import { Activity, Actor, Collection, CryptographicKey, Hashtag, Link, LookupObjectOptions, Multikey, Object as Object$1, Recipient, TraverseCollectionOptions } from "@fedify/vocab";
 import { AuthenticatedDocumentLoaderFactory, DocumentLoader, DocumentLoaderFactory, GetUserAgentOptions } from "@fedify/vocab-runtime";
-import { Span, TracerProvider } from "@opentelemetry/api";
+import { Link as Link$1, LookupWebFingerOptions, ResourceDescriptor } from "@fedify/webfinger";
+import { Span, Tracer, TracerProvider } from "@opentelemetry/api";
 
 //#region src/compat/types.d.ts
 /**
@@ -22,9 +19,9 @@ type ActivityTransformer<TContextData> = (activity: Activity, context: Context<T
  * A page of items.
  */
 interface PageItems<TItem> {
-  prevCursor?: string | null;
-  nextCursor?: string | null;
-  items: TItem[];
+  readonly prevCursor?: string | null;
+  readonly nextCursor?: string | null;
+  readonly items: readonly TItem[];
 }
 /**
  * Calculates the [partial follower collection digest][1].
@@ -54,11 +51,11 @@ interface SenderKeyPair {
   /**
    * The actor's private key to sign the request.
    */
-  privateKey: CryptoKey;
+  readonly privateKey: CryptoKey;
   /**
    * The public key ID that corresponds to the private key.
    */
-  keyId: URL;
+  readonly keyId: URL;
 }
 /**
  * Parameters for {@link sendActivity}.
@@ -306,8 +303,146 @@ type CustomCollectionCounter<TParam extends string, TContextData> = (context: Re
  */
 type CustomCollectionCursor<TParam extends string, TContext extends Context<TContextData>, TContextData> = (context: TContext, values: Record<TParam, string>) => string | null | Promise<string | null>;
 //#endregion
+//#region src/federation/mq.d.ts
+/**
+ * Additional options for enqueuing a message in a queue.
+ *
+ * @since 0.5.0
+ */
+interface MessageQueueEnqueueOptions {
+  /**
+   * The delay before the message is enqueued.  No delay by default.
+   *
+   * It must not be negative.
+   */
+  delay?: Temporal.Duration;
+}
+/**
+ * Additional options for listening to a message queue.
+ *
+ * @since 1.0.0
+ */
+interface MessageQueueListenOptions {
+  /**
+   * The signal to abort listening to the message queue.
+   */
+  signal?: AbortSignal;
+}
+/**
+ * An abstract interface for a message queue.
+ *
+ * @since 0.5.0
+ */
+interface MessageQueue {
+  /**
+   * Whether the message queue backend provides native retry mechanisms.
+   * When `true`, Fedify will skip its own retry logic and rely on the backend
+   * to handle retries. When `false` or omitted, Fedify will handle retries
+   * using its own retry policies.
+   *
+   * @default `false`
+   * @since 1.7.0
+   */
+  readonly nativeRetrial?: boolean;
+  /**
+   * Enqueues a message in the queue.
+   * @param message The message to enqueue.
+   * @param options Additional options for enqueuing the message.
+   */
+  enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
+  /**
+   * Enqueues multiple messages in the queue.  This operation is optional,
+   * and may not be supported by all implementations.  If not supported,
+   * Fedify will invoke {@link enqueue} for each message.
+   *
+   * @param messages The messages to enqueue.
+   * @param options Additional options for enqueuing the messages.
+   */
+  enqueueMany?: (messages: readonly any[], options?: MessageQueueEnqueueOptions) => Promise<void>;
+  /**
+   * Listens for messages in the queue.
+   * @param handler The handler for messages in the queue.
+   * @param options Additional options for listening to the message queue.
+   * @returns A promise that resolves when the listening is done.  It never
+   *          rejects, and is resolved when the signal is aborted.  If no
+   *          signal is provided, it never resolves.
+   */
+  listen(handler: (message: any) => Promise<void> | void, options?: MessageQueueListenOptions): Promise<void>;
+}
+/**
+ * Additional options for {@link InProcessMessageQueue}.
+ * @since 1.0.0
+ */
+interface InProcessMessageQueueOptions {
+  /**
+   * The interval to poll for messages in the queue.  5 seconds by default.
+   * @default `{ seconds: 5 }`
+   */
+  pollInterval?: Temporal.Duration | Temporal.DurationLike;
+}
+/**
+ * A message queue that processes messages in the same process.
+ * Do not use this in production as it does neither persist messages nor
+ * distribute them across multiple processes.
+ *
+ * @since 0.5.0
+ */
+declare class InProcessMessageQueue implements MessageQueue {
+  #private;
+  /**
+   * In-process message queue does not provide native retry mechanisms.
+   * @since 1.7.0
+   */
+  readonly nativeRetrial = false;
+  /**
+   * Constructs a new {@link InProcessMessageQueue} with the given options.
+   * @param options Additional options for the in-process message queue.
+   */
+  constructor(options?: InProcessMessageQueueOptions);
+  enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
+  enqueueMany(messages: readonly any[], options?: MessageQueueEnqueueOptions): Promise<void>;
+  listen(handler: (message: any) => Promise<void> | void, options?: MessageQueueListenOptions): Promise<void>;
+}
+/**
+ * A message queue that processes messages in parallel.  It takes another
+ * {@link MessageQueue}, and processes messages in parallel up to a certain
+ * number of workers.
+ *
+ * Actually, it's rather a decorator than a queue itself.
+ *
+ * Note that the workers do not run in truly parallel, in the sense that they
+ * are not running in separate threads or processes.  They are running in the
+ * same process, but are scheduled to run in parallel.  Hence, this is useful
+ * for I/O-bound tasks, but not for CPU-bound tasks, which is okay for Fedify's
+ * workloads.
+ *
+ * @since 1.0.0
+ */
+declare class ParallelMessageQueue implements MessageQueue {
+  #private;
+  readonly queue: MessageQueue;
+  readonly workers: number;
+  /**
+   * Inherits the native retry capability from the wrapped queue.
+   * @since 1.7.0
+   */
+  readonly nativeRetrial?: boolean;
+  /**
+   * Constructs a new {@link ParallelMessageQueue} with the given queue and
+   * number of workers.
+   * @param queue The message queue to use under the hood.  Note that
+   *              {@link ParallelMessageQueue} cannot be nested.
+   * @param workers The number of workers to process messages in parallel.
+   * @throws {TypeError} If the given queue is an instance of
+   *                     {@link ParallelMessageQueue}.
+   */
+  constructor(queue: MessageQueue, workers: number);
+  enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
+  enqueueMany(messages: readonly any[], options?: MessageQueueEnqueueOptions): Promise<void>;
+  listen(handler: (message: any) => Promise<void> | void, options?: MessageQueueListenOptions): Promise<void>;
+}
+//#endregion
 //#region src/federation/handler.d.ts
-
 /**
  * Options for the {@link respondWithObject} and
  * {@link respondWithObjectIfAcceptable} functions.
@@ -434,8 +569,8 @@ declare function createFederationBuilder<TContextData>(): FederationBuilder<TCon
 //#endregion
 //#region src/federation/queue.d.ts
 interface SenderKeyJwkPair {
-  keyId: string;
-  privateKey: JsonWebKey;
+  readonly keyId: string;
+  readonly privateKey: JsonWebKey;
 }
 /**
  * A message that represents a task to be processed by the background worker.
@@ -448,44 +583,44 @@ interface SenderKeyJwkPair {
  */
 type Message = FanoutMessage | OutboxMessage | InboxMessage;
 interface FanoutMessage {
-  type: "fanout";
-  id: ReturnType<typeof crypto.randomUUID>;
-  baseUrl: string;
-  keys: SenderKeyJwkPair[];
-  inboxes: Record<string, {
-    actorIds: string[];
-    sharedInbox: boolean;
-  }>;
-  activity: unknown;
-  activityId?: string;
-  activityType: string;
-  collectionSync?: string;
-  traceContext: Record<string, string>;
+  readonly type: "fanout";
+  readonly id: ReturnType<typeof crypto.randomUUID>;
+  readonly baseUrl: string;
+  readonly keys: readonly SenderKeyJwkPair[];
+  readonly inboxes: Readonly<Record<string, {
+    readonly actorIds: readonly string[];
+    readonly sharedInbox: boolean;
+  }>>;
+  readonly activity: unknown;
+  readonly activityId?: string;
+  readonly activityType: string;
+  readonly collectionSync?: string;
+  readonly traceContext: Readonly<Record<string, string>>;
 }
 interface OutboxMessage {
-  type: "outbox";
-  id: ReturnType<typeof crypto.randomUUID>;
-  baseUrl: string;
-  keys: SenderKeyJwkPair[];
-  activity: unknown;
-  activityId?: string;
-  activityType: string;
-  inbox: string;
-  sharedInbox: boolean;
-  started: string;
-  attempt: number;
-  headers: Record<string, string>;
-  traceContext: Record<string, string>;
+  readonly type: "outbox";
+  readonly id: ReturnType<typeof crypto.randomUUID>;
+  readonly baseUrl: string;
+  readonly keys: readonly SenderKeyJwkPair[];
+  readonly activity: unknown;
+  readonly activityId?: string;
+  readonly activityType: string;
+  readonly inbox: string;
+  readonly sharedInbox: boolean;
+  readonly started: string;
+  readonly attempt: number;
+  readonly headers: Readonly<Record<string, string>>;
+  readonly traceContext: Readonly<Record<string, string>>;
 }
 interface InboxMessage {
-  type: "inbox";
-  id: ReturnType<typeof crypto.randomUUID>;
-  baseUrl: string;
-  activity: unknown;
-  started: string;
-  attempt: number;
-  identifier: string | null;
-  traceContext: Record<string, string>;
+  readonly type: "inbox";
+  readonly id: ReturnType<typeof crypto.randomUUID>;
+  readonly baseUrl: string;
+  readonly activity: unknown;
+  readonly started: string;
+  readonly attempt: number;
+  readonly identifier: string | null;
+  readonly traceContext: Readonly<Record<string, string>>;
 }
 //#endregion
 //#region src/federation/retry.d.ts
@@ -569,19 +704,19 @@ interface FederationQueueOptions {
    * The message queue for incoming activities.  If not provided, incoming
    * activities will not be queued and will be processed immediately.
    */
-  inbox?: MessageQueue;
+  readonly inbox?: MessageQueue;
   /**
    * The message queue for outgoing activities.  If not provided, outgoing
    * activities will not be queued and will be sent immediately.
    */
-  outbox?: MessageQueue;
+  readonly outbox?: MessageQueue;
   /**
    * The message queue for fanning out outgoing activities.  If not provided,
    * outgoing activities will not be fanned out in the background, but will be
    * fanned out immediately, which causes slow response times on
    * {@link Context.sendActivity} calls.
    */
-  fanout?: MessageQueue;
+  readonly fanout?: MessageQueue;
 }
 /**
  * Prefixes for namespacing keys in the Deno KV store.
@@ -592,18 +727,18 @@ interface FederationKvPrefixes {
    * processed or not.
    * @default `["_fedify", "activityIdempotence"]`
    */
-  activityIdempotence: KvKey;
+  readonly activityIdempotence: KvKey;
   /**
    * The key prefix used for storing remote JSON-LD documents.
    * @default `["_fedify", "remoteDocument"]`
    */
-  remoteDocument: KvKey;
+  readonly remoteDocument: KvKey;
   /**
    * The key prefix used for caching public keys.
    * @default `["_fedify", "publicKey"]`
    * @since 0.12.0
    */
-  publicKey: KvKey;
+  readonly publicKey: KvKey;
   /**
    * The key prefix used for caching HTTP Message Signatures specs.
    * The cached spec is used to reduce the number of requests to make signed
@@ -611,7 +746,7 @@ interface FederationKvPrefixes {
    * @default `["_fedify", "httpMessageSignaturesSpec"]`
    * @since 1.6.0
    */
-  httpMessageSignaturesSpec: KvKey;
+  readonly httpMessageSignaturesSpec: KvKey;
 }
 /**
  * Options for {@link CreateFederationOptions.origin} when it is not a string.
@@ -2025,7 +2160,7 @@ interface InboxContext<TContextData> extends Context<TContextData> {
    * inbox, it is `null`.
    * @since 1.2.0
    */
-  recipient: string | null;
+  readonly recipient: string | null;
   /**
    * Creates a new context with the same properties as this one,
    * but with the given data.
@@ -2215,7 +2350,7 @@ interface SendActivityOptions {
    *
    * @since 0.9.0
    */
-  excludeBaseUris?: URL[];
+  readonly excludeBaseUris?: readonly URL[];
 }
 /**
  * Options for {@link Context.sendActivity} method when sending to a collection.
@@ -2298,15 +2433,15 @@ interface ActorKeyPair extends CryptoKeyPair {
   /**
    * The URI of the public key, which is used for verifying HTTP Signatures.
    */
-  keyId: URL;
+  readonly keyId: URL;
   /**
    * A {@link CryptographicKey} instance of the public key.
    */
-  cryptographicKey: CryptographicKey;
+  readonly cryptographicKey: CryptographicKey;
   /**
    * A {@link Multikey} instance of the public key.
    */
-  multikey: Multikey;
+  readonly multikey: Multikey;
 }
 //#endregion
-export { ActivityTransformer, ActorAliasMapper, ActorCallbackSetters, ActorDispatcher, ActorHandleMapper, ActorKeyPair, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionCallbackSetters, CollectionCounter, CollectionCursor, CollectionDispatcher, ConstructorWithTypeId, Context, CreateExponentialBackoffPolicyOptions, CreateFederationOptions, CustomCollectionCallbackSetters, CustomCollectionCounter, CustomCollectionCursor, CustomCollectionDispatcher, Federatable, Federation, FederationBuilder, FederationFetchOptions, FederationKvPrefixes, FederationOptions, FederationOrigin, FederationQueueOptions, FederationStartQueueOptions, ForwardActivityOptions, GetSignedKeyOptions, IdempotencyKeyCallback, IdempotencyStrategy, InboxContext, InboxErrorHandler, InboxListener, InboxListenerSetters, Message, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectCallbackSetters, ObjectDispatcher, OutboxErrorHandler, PageItems, ParseUriResult, RequestContext, RespondWithObjectOptions, RetryContext, RetryPolicy, Rfc6570Expression, RouteActivityOptions, Router, RouterError, RouterOptions, RouterRouteResult, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, SharedInboxKeyDispatcher, WebFingerLinksDispatcher, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, respondWithObject, respondWithObjectIfAcceptable };
+export { ActivityTransformer, ActorAliasMapper, ActorCallbackSetters, ActorDispatcher, ActorHandleMapper, ActorKeyPair, ActorKeyPairsDispatcher, AuthorizePredicate, CollectionCallbackSetters, CollectionCounter, CollectionCursor, CollectionDispatcher, ConstructorWithTypeId, Context, CreateExponentialBackoffPolicyOptions, CreateFederationOptions, CustomCollectionCallbackSetters, CustomCollectionCounter, CustomCollectionCursor, CustomCollectionDispatcher, Federatable, Federation, FederationBuilder, FederationFetchOptions, FederationKvPrefixes, FederationOptions, FederationOrigin, FederationQueueOptions, FederationStartQueueOptions, ForwardActivityOptions, GetSignedKeyOptions, IdempotencyKeyCallback, IdempotencyStrategy, InProcessMessageQueue, InProcessMessageQueueOptions, InboxContext, InboxErrorHandler, InboxListener, InboxListenerSetters, Message, MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions, NodeInfoDispatcher, ObjectAuthorizePredicate, ObjectCallbackSetters, ObjectDispatcher, OutboxErrorHandler, PageItems, ParallelMessageQueue, ParseUriResult, RequestContext, RespondWithObjectOptions, RetryContext, RetryPolicy, Rfc6570Expression, RouteActivityOptions, Router, RouterError, RouterOptions, RouterRouteResult, SendActivityOptions, SendActivityOptionsForCollection, SenderKeyPair, SharedInboxKeyDispatcher, WebFingerLinksDispatcher, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, respondWithObject, respondWithObjectIfAcceptable };

package/dist/deno-i60L3ZJW.js

@@ -0,0 +1,117 @@
+
+      import { Temporal } from "@js-temporal/polyfill";
+      import { URLPattern } from "urlpattern-polyfill";
+      globalThis.addEventListener = () => {};
+    
+//#region deno.json
+var name = "@fedify/fedify";
+var version = "2.0.0-dev.196+c3cfc0a9";
+var license = "MIT";
+var exports = {
+	".": "./src/mod.ts",
+	"./compat": "./src/compat/mod.ts",
+	"./federation": "./src/federation/mod.ts",
+	"./nodeinfo": "./src/nodeinfo/mod.ts",
+	"./otel": "./src/otel/mod.ts",
+	"./sig": "./src/sig/mod.ts",
+	"./utils": "./src/utils/mod.ts"
+};
+var imports = {
+	"@multiformats/base-x": "npm:@multiformats/base-x@^4.0.1",
+	"@opentelemetry/core": "npm:@opentelemetry/core@^2.0.0",
+	"@opentelemetry/sdk-trace-base": "npm:@opentelemetry/sdk-trace-base@^2.0.0",
+	"@opentelemetry/semantic-conventions": "npm:@opentelemetry/semantic-conventions@^1.27.0",
+	"@std/assert": "jsr:@std/assert@^0.226.0",
+	"@std/url": "jsr:@std/url@^0.225.1",
+	"asn1js": "npm:asn1js@^3.0.7",
+	"fast-check": "npm:fast-check@^3.22.0",
+	"fetch-mock": "npm:fetch-mock@^12.5.2",
+	"json-canon": "npm:json-canon@^1.0.1",
+	"jsonld": "npm:jsonld@^9.0.0",
+	"multicodec": "npm:multicodec@^3.2.1",
+	"pkijs": "npm:pkijs@^3.3.3",
+	"structured-field-values": "npm:structured-field-values@^2.0.4",
+	"uri-template-router": "npm:uri-template-router@^1.0.0",
+	"url-template": "npm:url-template@^3.1.1"
+};
+var exclude = [
+	".test-report.xml",
+	"apidoc/",
+	"dist/",
+	"node_modules/",
+	"npm/",
+	"pnpm-lock.yaml",
+	"src/cfworkers/dist/",
+	"src/cfworkers/fixtures/",
+	"src/cfworkers/imports.ts",
+	"src/cfworkers/README.md",
+	"src/cfworkers/server.ts",
+	"src/cfworkers/server.js",
+	"src/cfworkers/server.js.map"
+];
+var publish = { "exclude": ["**/*.test.ts", "src/testing/"] };
+var tasks = {
+	"codegen": "deno task -f @fedify/vocab compile",
+	"cache": {
+		"command": "deno cache src/mod.ts",
+		"dependencies": ["codegen"]
+	},
+	"check": {
+		"command": "deno fmt --check && deno lint && deno check src/**/*.ts",
+		"dependencies": ["codegen"]
+	},
+	"test": {
+		"command": "deno test --check --doc --allow-read --allow-write --allow-env --unstable-kv --trace-leaks --parallel",
+		"dependencies": ["codegen"]
+	},
+	"coverage": "deno task test --clean --coverage && deno coverage --html coverage",
+	"bench": {
+		"command": "deno bench --allow-read --allow-write --allow-net --allow-env --allow-run --unstable-kv",
+		"dependencies": ["codegen"]
+	},
+	"apidoc": {
+		"command": "deno doc --html --name=Fedify --output=apidoc/ src/mod.ts",
+		"dependencies": ["codegen"]
+	},
+	"publish": {
+		"command": "deno publish",
+		"dependencies": ["codegen"]
+	},
+	"pnpm:install": "pnpm install --silent",
+	"pnpm:build": {
+		"command": "pnpm exec tsdown",
+		"dependencies": ["pnpm:build-vocab"]
+	},
+	"test:node": {
+		"command": "cd dist/ && node --test",
+		"dependencies": ["pnpm:build"]
+	},
+	"test:bun": {
+		"command": "cd dist/ && bun test --timeout 60000",
+		"dependencies": ["pnpm:build"]
+	},
+	"test:cfworkers": {
+		"command": "pnpm exec wrangler deploy --dry-run --outdir src/cfworkers && node --import=tsx src/cfworkers/client.ts",
+		"dependencies": ["pnpm:build"]
+	},
+	"test-all": { "dependencies": [
+		"check",
+		"test",
+		"test:node",
+		"test:bun",
+		"test:cfworkers"
+	] }
+};
+var deno_default = {
+	name,
+	version,
+	license,
+	exports,
+	imports,
+	exclude,
+	publish,
+	tasks
+};
+
+//#endregion
+export { deno_default };