@fedify/vocab-runtime 2.3.0-dev.1274 → 2.3.0-dev.1280

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.3.0-dev.1274+8e82de77",
+  "version": "2.3.0-dev.1280+7bca39c7",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/mod.cjs

@@ -4346,7 +4346,7 @@ const preloadedContexts = {
 //#endregion
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.3.0-dev.1274+8e82de77";
+var version = "2.3.0-dev.1280+7bca39c7";
 //#endregion
 //#region src/link.ts
 const parametersNeedLowerCase = ["rel", "type"];

package/dist/mod.d.cts

@@ -1,5 +1,6 @@
 /// <reference lib="esnext.temporal" />
 import { Logger } from "@logtape/logtape";
+import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/contexts.d.ts
 declare const preloadedContexts: Record<string, unknown>;
@@ -422,6 +423,39 @@ declare function decodeMultibase(data: Uint8Array | string): Uint8Array;
 */
 declare function encodingFromBaseData(data: string | Uint8Array): Base;
 //#endregion
+//#region src/preprocessor.d.ts
+/**
+* JSON value shape passed to property preprocessors.
+* @since 2.3.0
+*/
+type Json = string | number | boolean | null | readonly Json[] | {
+  readonly [key: string]: Json;
+};
+/**
+* Runtime context provided to property preprocessors.
+* @since 2.3.0
+*/
+interface PropertyPreprocessorContext {
+  /** Loader for remote JSON-LD documents. */
+  documentLoader?: DocumentLoader;
+  /** Loader for remote JSON-LD contexts. */
+  contextLoader?: DocumentLoader;
+  /** OpenTelemetry tracer provider for instrumentation. */
+  tracerProvider?: TracerProvider;
+  /** Base URL for resolving relative references. */
+  baseUrl?: URL;
+}
+/**
+* Function signature for schema-configured property preprocessors.
+*
+* Receives an expanded JSON-LD property value and returns a vocabulary
+* object when the value is handled, `undefined` when the value should
+* fall through to the normal range decoder, or an `Error` when the value
+* is recognized but cannot be converted.
+* @since 2.3.0
+*/
+type PropertyPreprocessor<T = unknown> = (value: Json, context: PropertyPreprocessorContext) => T | undefined | Error | Promise<T | undefined | Error>;
+//#endregion
 //#region src/url.d.ts
 declare class UrlError extends Error {
   constructor(message: string);
@@ -434,4 +468,4 @@ declare function isValidPublicIPv4Address(address: string): boolean;
 declare function isValidPublicIPv6Address(address: string): boolean;
 declare function expandIPv6Address(address: string): string;
 //#endregion
-export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type GetDocumentLoaderOptions, type GetUserAgentOptions, LanguageString, type RemoteDocument, UrlError, canParseDecimal, createActivityPubRequest, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportMultibaseKey, exportSpki, getDocumentLoader, getRemoteDocument, getUserAgent, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, parseDecimal, preloadedContexts, validatePublicUrl };
+export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, canParseDecimal, createActivityPubRequest, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportMultibaseKey, exportSpki, getDocumentLoader, getRemoteDocument, getUserAgent, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, parseDecimal, preloadedContexts, validatePublicUrl };

package/dist/mod.d.ts

@@ -1,5 +1,6 @@
 /// <reference lib="esnext.temporal" />
 import { Logger } from "@logtape/logtape";
+import { TracerProvider } from "@opentelemetry/api";
 
 //#region src/contexts.d.ts
 declare const preloadedContexts: Record<string, unknown>;
@@ -422,6 +423,39 @@ declare function decodeMultibase(data: Uint8Array | string): Uint8Array;
 */
 declare function encodingFromBaseData(data: string | Uint8Array): Base;
 //#endregion
+//#region src/preprocessor.d.ts
+/**
+* JSON value shape passed to property preprocessors.
+* @since 2.3.0
+*/
+type Json = string | number | boolean | null | readonly Json[] | {
+  readonly [key: string]: Json;
+};
+/**
+* Runtime context provided to property preprocessors.
+* @since 2.3.0
+*/
+interface PropertyPreprocessorContext {
+  /** Loader for remote JSON-LD documents. */
+  documentLoader?: DocumentLoader;
+  /** Loader for remote JSON-LD contexts. */
+  contextLoader?: DocumentLoader;
+  /** OpenTelemetry tracer provider for instrumentation. */
+  tracerProvider?: TracerProvider;
+  /** Base URL for resolving relative references. */
+  baseUrl?: URL;
+}
+/**
+* Function signature for schema-configured property preprocessors.
+*
+* Receives an expanded JSON-LD property value and returns a vocabulary
+* object when the value is handled, `undefined` when the value should
+* fall through to the normal range decoder, or an `Error` when the value
+* is recognized but cannot be converted.
+* @since 2.3.0
+*/
+type PropertyPreprocessor<T = unknown> = (value: Json, context: PropertyPreprocessorContext) => T | undefined | Error | Promise<T | undefined | Error>;
+//#endregion
 //#region src/url.d.ts
 declare class UrlError extends Error {
   constructor(message: string);
@@ -434,4 +468,4 @@ declare function isValidPublicIPv4Address(address: string): boolean;
 declare function isValidPublicIPv6Address(address: string): boolean;
 declare function expandIPv6Address(address: string): string;
 //#endregion
-export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type GetDocumentLoaderOptions, type GetUserAgentOptions, LanguageString, type RemoteDocument, UrlError, canParseDecimal, createActivityPubRequest, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportMultibaseKey, exportSpki, getDocumentLoader, getRemoteDocument, getUserAgent, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, parseDecimal, preloadedContexts, validatePublicUrl };
+export { type AuthenticatedDocumentLoaderFactory, type CreateRequestOptions, type Decimal, type DocumentLoader, type DocumentLoaderFactory, type DocumentLoaderFactoryOptions, type DocumentLoaderOptions, FetchError, type GetDocumentLoaderOptions, type GetUserAgentOptions, type Json, LanguageString, type PropertyPreprocessor, type PropertyPreprocessorContext, type RemoteDocument, UrlError, canParseDecimal, createActivityPubRequest, decodeMultibase, encodeMultibase, encodingFromBaseData, expandIPv6Address, exportMultibaseKey, exportSpki, getDocumentLoader, getRemoteDocument, getUserAgent, importMultibaseKey, importPem, importPkcs1, importSpki, isDecimal, isValidPublicIPv4Address, isValidPublicIPv6Address, logRequest, parseDecimal, preloadedContexts, validatePublicUrl };

package/dist/mod.js

@@ -4342,7 +4342,7 @@ const preloadedContexts = {
 //#endregion
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.3.0-dev.1274+8e82de77";
+var version = "2.3.0-dev.1280+7bca39c7";
 //#endregion
 //#region src/link.ts
 const parametersNeedLowerCase = ["rel", "type"];

package/dist/tests/decimal.test.cjs

@@ -1,5 +1,5 @@
 require("./chunk-C2EiDwsr.cjs");
-require("./docloader-DYrZUNI_.cjs");
+require("./docloader-BncEYlGn.cjs");
 require("./url-C20FhC7p.cjs");
 require("./key-pMmqUKuo.cjs");
 require("./multibase-Bz_UUDtL.cjs");

package/dist/tests/decimal.test.mjs

@@ -1,4 +1,4 @@
-import "./docloader-CppaPUml.mjs";
+import "./docloader-Cj4nLvSv.mjs";
 import "./url-m9Qzxy-Y.mjs";
 import "./key-CrrK9mYh.mjs";
 import "./multibase-B4bvakyA.mjs";

package/dist/tests/{docloader-DYrZUNI_.cjs → docloader-BncEYlGn.cjs}

@@ -1,5 +1,5 @@
 require("./chunk-C2EiDwsr.cjs");
-const require_request = require("./request-Dur0B_FP.cjs");
+const require_request = require("./request--iJUBB5d.cjs");
 const require_link = require("./link-FguCydMA.cjs");
 const require_url = require("./url-C20FhC7p.cjs");
 let _logtape_logtape = require("@logtape/logtape");

package/dist/tests/{docloader-CppaPUml.mjs → docloader-Cj4nLvSv.mjs}

@@ -1,4 +1,4 @@
-import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-BxDr_45l.mjs";
+import { a as name, i as logRequest, n as createActivityPubRequest, o as version, t as FetchError } from "./request-C357OI5N.mjs";
 import { t as HttpHeaderLink } from "./link-NUUWCdnK.mjs";
 import { a as validatePublicUrl, t as UrlError } from "./url-m9Qzxy-Y.mjs";
 import { getLogger } from "@logtape/logtape";

package/dist/tests/docloader.test.cjs

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-C2EiDwsr.cjs");
-const require_docloader = require("./docloader-DYrZUNI_.cjs");
-const require_request = require("./request-Dur0B_FP.cjs");
+const require_docloader = require("./docloader-BncEYlGn.cjs");
+const require_request = require("./request--iJUBB5d.cjs");
 const require_url = require("./url-C20FhC7p.cjs");
 let node_assert = require("node:assert");
 let node_test = require("node:test");

package/dist/tests/docloader.test.mjs

@@ -1,5 +1,5 @@
-import { n as preloadedContexts, t as getDocumentLoader } from "./docloader-CppaPUml.mjs";
-import { t as FetchError } from "./request-BxDr_45l.mjs";
+import { n as preloadedContexts, t as getDocumentLoader } from "./docloader-Cj4nLvSv.mjs";
+import { t as FetchError } from "./request-C357OI5N.mjs";
 import { t as UrlError } from "./url-m9Qzxy-Y.mjs";
 import { deepStrictEqual, ok, rejects } from "node:assert";
 import { test } from "node:test";

package/dist/tests/{request-Dur0B_FP.cjs → request--iJUBB5d.cjs}

@@ -3,7 +3,7 @@ let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process, 1);
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.3.0-dev.1274+8e82de77";
+var version = "2.3.0-dev.1280+7bca39c7";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/{request-BxDr_45l.mjs → request-C357OI5N.mjs}

@@ -1,7 +1,7 @@
 import process from "node:process";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.3.0-dev.1274+8e82de77";
+var version = "2.3.0-dev.1280+7bca39c7";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/request.test.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-C2EiDwsr.cjs");
-const require_request = require("./request-Dur0B_FP.cjs");
+const require_request = require("./request--iJUBB5d.cjs");
 let node_assert = require("node:assert");
 let node_test = require("node:test");
 let node_process = require("node:process");

package/dist/tests/request.test.mjs

@@ -1,4 +1,4 @@
-import { o as version, r as getUserAgent } from "./request-BxDr_45l.mjs";
+import { o as version, r as getUserAgent } from "./request-C357OI5N.mjs";
 import { deepStrictEqual } from "node:assert";
 import { test } from "node:test";
 import process from "node:process";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.3.0-dev.1274+8e82de77",
+  "version": "2.3.0-dev.1280+7bca39c7",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",

package/src/mod.ts

@@ -44,6 +44,11 @@ export {
   type GetUserAgentOptions,
   logRequest,
 } from "./request.ts";
+export {
+  type Json,
+  type PropertyPreprocessor,
+  type PropertyPreprocessorContext,
+} from "./preprocessor.ts";
 export {
   expandIPv6Address,
   isValidPublicIPv4Address,

package/src/preprocessor.ts

@@ -0,0 +1,43 @@
+import type { DocumentLoader } from "./docloader.ts";
+import type { TracerProvider } from "@opentelemetry/api";
+
+/**
+ * JSON value shape passed to property preprocessors.
+ * @since 2.3.0
+ */
+export type Json =
+  | string
+  | number
+  | boolean
+  | null
+  | readonly Json[]
+  | { readonly [key: string]: Json };
+
+/**
+ * Runtime context provided to property preprocessors.
+ * @since 2.3.0
+ */
+export interface PropertyPreprocessorContext {
+  /** Loader for remote JSON-LD documents. */
+  documentLoader?: DocumentLoader;
+  /** Loader for remote JSON-LD contexts. */
+  contextLoader?: DocumentLoader;
+  /** OpenTelemetry tracer provider for instrumentation. */
+  tracerProvider?: TracerProvider;
+  /** Base URL for resolving relative references. */
+  baseUrl?: URL;
+}
+
+/**
+ * Function signature for schema-configured property preprocessors.
+ *
+ * Receives an expanded JSON-LD property value and returns a vocabulary
+ * object when the value is handled, `undefined` when the value should
+ * fall through to the normal range decoder, or an `Error` when the value
+ * is recognized but cannot be converted.
+ * @since 2.3.0
+ */
+export type PropertyPreprocessor<T = unknown> = (
+  value: Json,
+  context: PropertyPreprocessorContext,
+) => T | undefined | Error | Promise<T | undefined | Error>;