@registrystack/client 0.38.0 → 0.39.0

package/README.md

@@ -1,6 +1,6 @@
 # @registrystack/client
 
-One versioned Node.js package for the Discovery, Evidence, Relay, Base Registry
+One versioned Node.js package for the Discovery, Evidence, Base Registry
 Engine, Casework, and Messaging client APIs in Registry Stack.
 
 ## Install
@@ -11,13 +11,13 @@ npm install "@registrystack/client@<version>"
 
 Requires Node.js 22.12 or newer. Supported targets are macOS arm64, Linux
 arm64 with glibc, and Linux x64 with glibc; installing the package pulls in
-one platform-specific optional dependency containing all six native
+one platform-specific optional dependency containing all five native
 bindings.
 
 ## Usage
 
 ```js
-const { discovery, evidence, relay, breg, casework, messaging } = require('@registrystack/client');
+const { discovery, evidence, breg, casework, messaging } = require('@registrystack/client');
 
 const registry = new breg.BaseRegistryClient({
   baseUrl: 'https://registry.example.invalid/',
@@ -36,7 +36,6 @@ const messages = new messaging.MessagingClient({
   curated index.
 - `evidence`: Evidence Gateway, request and verify signed minimum-disclosure
   assertions.
-- `relay`: Registry Relay, scoped read-only APIs over existing sources.
 - `breg`: Base Registry Engine, records, contracts, writes, lifecycle, and typed
   applied-request result navigation.
 - `casework`: Registry Casework, staff inbox, claims, drafts, decisions,

package/breg/client.d.ts

@@ -349,8 +349,17 @@ export interface RawOutcome {
   mediaType: string
   traceId: string
   etag?: string
+  reprDigest?: string
 }
 
+export type StatisticsFormat = 'json' | 'csv'
+export type StatisticsReleaseStatus = 'provisional' | 'final'
+export type StatisticsReleaseSelection = 'any' | 'final'
+export type StatisticsWithdrawalReason =
+  | 'computation-error'
+  | 'source-data-error'
+  | 'disclosure-risk'
+
 export interface PatchOperation {
   op: 'add' | 'replace' | 'test'
   field: string
@@ -986,6 +995,8 @@ export interface BaseRegistryClientFailure extends Error {
   readonly code?: string
   readonly planRefusal?: string
   readonly refusalCode?: string
+  readonly reasonCode?: string
+  readonly fieldPath?: string
   readonly status?: number
   readonly traceId?: string
   readonly transportKind?: string
@@ -997,6 +1008,8 @@ export declare class BaseRegistryClientError extends Error implements BaseRegist
   readonly code?: string
   readonly planRefusal?: string
   readonly refusalCode?: string
+  readonly reasonCode?: string
+  readonly fieldPath?: string
   readonly status?: number
   readonly traceId?: string
   readonly transportKind?: string
@@ -1009,6 +1022,13 @@ export declare class BaseRegistryClient {
   ready(): Promise<CompleteOutcome<ProbeStatus>>
   openapi(accessProfile?: string | null): Promise<RawOutcome>
   registryMetadata(accessProfile?: string | null): Promise<RawOutcome>
+  statisticsLive(dataset: string, from?: string | null, to?: string | null, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>
+  statisticsReleases(dataset: string, top?: SafeInteger | null, skipToken?: string | null, accessProfile?: string | null): Promise<RawOutcome>
+  statisticsLatestRelease(dataset: string, period: string, selection: StatisticsReleaseSelection, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>
+  statisticsReleaseVersion(dataset: string, period: string, version: SafeInteger, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>
+  statisticsReleaseSeries(dataset: string, from: string, to: string, selection: StatisticsReleaseSelection, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>
+  statisticsPublish(dataset: string, period: string, status: StatisticsReleaseStatus, accessProfile: string, idempotencyKey: string): Promise<RawOutcome>
+  statisticsWithdraw(dataset: string, period: string, version: SafeInteger, reason: StatisticsWithdrawalReason, accessProfile: string, idempotencyKey: string): Promise<RawOutcome>
   registryContract(accessProfile?: string | null): Promise<BRegMetadata>
   entitySchema(entityIdentifier: string, accessProfile?: string | null): Promise<RawOutcome>
   recordRevisions(entityRoute: string, recordIdentifier: string, accessProfile?: string | null): Promise<RawOutcome>

package/breg/client.js

@@ -12,9 +12,17 @@ class BaseRegistryClientError extends Error {
     super(envelope.message);
     this.name = 'BaseRegistryClientError';
     this.kind = envelope.kind;
-    for (const field of ['code', 'planRefusal', 'refusalCode', 'status', 'traceId', 'transportKind', 'tokenKind']) {
+    for (const field of ['code', 'planRefusal', 'refusalCode', 'reasonCode', 'status', 'traceId', 'transportKind', 'tokenKind']) {
       if (envelope[field] !== undefined && envelope[field] !== null) this[field] = envelope[field];
     }
+    if (envelope.fieldPath !== undefined && envelope.fieldPath !== null) {
+      Object.defineProperty(this, 'fieldPath', {
+        value: envelope.fieldPath,
+        configurable: true,
+        enumerable: false,
+        writable: true,
+      });
+    }
   }
 }
 
@@ -197,6 +205,9 @@ function wrapAsync(name, jsonIndexes = [], requiredIndexes = []) {
 
 for (const [method, jsonIndexes, requiredIndexes] of [
   ['health'], ['ready'], ['openapi'], ['registryMetadata'], ['registryContract'], ['entitySchema'],
+  ['statisticsLive'], ['statisticsReleases'], ['statisticsLatestRelease'],
+  ['statisticsReleaseVersion'], ['statisticsReleaseSeries'], ['statisticsPublish'],
+  ['statisticsWithdraw'],
   ['recordRevisions'], ['getRecordRevision', [3]],
   ['getRecord', [2]], ['listRecords', [1]], ['continueList', [0], [0]],
   ['getGeoJsonRecord', [2]], ['listGeoJsonRecords', [1]], ['continueGeoJsonList', [0], [0]],

package/breg/index.d.ts

@@ -7,6 +7,13 @@ export declare class BaseRegistryClient {
   ready(): Promise<CompleteOutcome>
   openapi(accessProfile?: string | undefined | null): Promise<RawOutcome>
   registryMetadata(accessProfile?: string | undefined | null): Promise<RawOutcome>
+  statisticsLive(dataset: string, from?: string | undefined | null, to?: string | undefined | null, accessProfile?: string | undefined | null, format?: string | undefined | null): Promise<RawOutcome>
+  statisticsReleases(dataset: string, top?: number | undefined | null, skipToken?: string | undefined | null, accessProfile?: string | undefined | null): Promise<RawOutcome>
+  statisticsLatestRelease(dataset: string, period: string, selection: string, accessProfile?: string | undefined | null, format?: string | undefined | null): Promise<RawOutcome>
+  statisticsReleaseVersion(dataset: string, period: string, version: number, accessProfile?: string | undefined | null, format?: string | undefined | null): Promise<RawOutcome>
+  statisticsReleaseSeries(dataset: string, from: string, to: string, selection: string, accessProfile?: string | undefined | null, format?: string | undefined | null): Promise<RawOutcome>
+  statisticsPublish(dataset: string, period: string, status: string, accessProfile: string, idempotencyKey: string): Promise<RawOutcome>
+  statisticsWithdraw(dataset: string, period: string, version: number, reason: string, accessProfile: string, idempotencyKey: string): Promise<RawOutcome>
   registryContract(accessProfile?: string | undefined | null): Promise<BRegMetadata>
   entitySchema(entityIdentifier: string, accessProfile?: string | undefined | null): Promise<RawOutcome>
   /** Retrieve one bounded first page of record revisions as inert JSON. */
@@ -369,6 +376,7 @@ export interface RawOutcome {
   mediaType: string
   traceId: string
   etag?: string
+  reprDigest?: string
 }
 
 /** Authenticated BReg webhook metadata and exact body. */

package/discovery/client.d.ts

@@ -1,4 +1,4 @@
-export type ServiceKind = 'evidence' | 'relay';
+export type ServiceKind = 'evidence';
 
 export interface DiscoveryClientOptions {
   baseUrl: string;
@@ -32,8 +32,6 @@ export interface ServiceFilters {
   jurisdiction?: string[];
   conformsTo?: string[];
   evidenceType?: string[];
-  semanticClass?: string[];
-  operationFamily?: string[];
 }
 
 export interface EvidenceServiceQuery {
@@ -43,17 +41,6 @@ export interface EvidenceServiceQuery {
   conformsTo?: string[];
 }
 
-interface RelayServiceQueryOptions {
-  jurisdiction?: string;
-  serviceIds?: string[];
-  conformsTo?: string[];
-}
-
-export type RelayServiceQuery = RelayServiceQueryOptions & (
-  | { semanticClassId: string; operationFamilyId?: string }
-  | { semanticClassId?: string; operationFamilyId: string }
-);
-
 export interface ServiceRecord {
   recordId: string;
   bindingId: string;
@@ -83,10 +70,7 @@ export interface ServiceSearchResponse {
   items: ServiceRecord[];
 }
 
-export type MatchedCapability =
-  | { kind: 'evidence-type'; id: string }
-  | { kind: 'semantic-class'; id: string }
-  | { kind: 'operation-family'; id: string };
+export type MatchedCapability = { kind: 'evidence-type'; id: string };
 
 export interface SelectionRequest {
   recordId: string;
@@ -110,15 +94,6 @@ export interface EvidenceSelectionRequest {
   resolution?: EvidenceResolutionContext;
 }
 
-export type RelayCapabilityMatch =
-  | { semanticClassId: string; operationFamilyId?: string }
-  | { semanticClassId?: string; operationFamilyId: string };
-
-export interface RelaySelectionRequest {
-  recordId: string;
-  capabilityMatch: RelayCapabilityMatch;
-}
-
 export interface CommonServiceSelection extends Omit<ServiceRecord, 'title' | 'description'> {
   matchedCapability: MatchedCapability;
   catalogRevision: string;
@@ -131,14 +106,6 @@ export interface EvidenceServiceSelection extends CommonServiceSelection {
   evidenceResolution?: EvidenceResolutionContext;
 }
 
-export interface RelayServiceSelection extends CommonServiceSelection {
-  serviceKind: 'relay';
-  matchedCapability:
-    | { kind: 'semantic-class'; id: string }
-    | { kind: 'operation-family'; id: string };
-  relayCapabilityMatch: RelayCapabilityMatch;
-}
-
 export type ServiceSelection = CommonServiceSelection;
 
 export type DiscoveryClientErrorKind =
@@ -168,7 +135,6 @@ export class DiscoveryClient {
   resolveEvidenceTypes(request: EvidenceTypeResolveRequest): Promise<EvidenceTypeResolveResponse>;
   searchServices(filters?: ServiceFilters): Promise<ServiceSearchResponse>;
   searchEvidenceServices(query: EvidenceServiceQuery): Promise<ServiceSearchResponse>;
-  searchRelayServices(query: RelayServiceQuery): Promise<ServiceSearchResponse>;
   selectExact(response: ServiceSearchResponse, request: SelectionRequest): CommonServiceSelection;
   selectEvidenceAlternative(
     response: EvidenceTypeResolveResponse,
@@ -178,10 +144,6 @@ export class DiscoveryClient {
     response: ServiceSearchResponse,
     request: EvidenceSelectionRequest,
   ): EvidenceServiceSelection;
-  selectRelayService(
-    response: ServiceSearchResponse,
-    request: RelaySelectionRequest,
-  ): RelayServiceSelection;
 }
 
 export function selectExact(
@@ -199,11 +161,6 @@ export function selectEvidenceService(
   request: EvidenceSelectionRequest,
 ): EvidenceServiceSelection;
 
-export function selectRelayService(
-  response: ServiceSearchResponse,
-  request: RelaySelectionRequest,
-): RelayServiceSelection;
-
 /**
  * Validate closed shape and capability binding only.
  *

package/discovery/client.js

@@ -222,14 +222,6 @@ class DiscoveryClient {
     }
   }
 
-  async searchRelayServices(query) {
-    try {
-      return await this.#inner.searchRelayServices(requestValue(query));
-    } catch (error) {
-      throw normalize(error, 'query');
-    }
-  }
-
   selectExact(response, request) {
     try {
       return this.#inner.selectExact(responseValue(response), requestValue(request));
@@ -246,9 +238,6 @@ class DiscoveryClient {
     return selectEvidenceService(response, request);
   }
 
-  selectRelayService(response, request) {
-    return selectRelayService(response, request);
-  }
 }
 
 function selectExact(response, request) {
@@ -278,14 +267,6 @@ function selectEvidenceService(response, request) {
   }
 }
 
-function selectRelayService(response, request) {
-  try {
-    return native.selectRelayService(responseValue(response), requestValue(request));
-  } catch (error) {
-    throw normalize(error, 'query');
-  }
-}
-
 function validateSelectionStructure(selection) {
   try {
     return native.validateSelectionStructure(requestValue(selection));
@@ -323,7 +304,6 @@ module.exports = {
   selectEvidenceAlternative,
   selectEvidenceService,
   selectExact,
-  selectRelayService,
   validateSelection,
   validateSelectionStructure,
 };

package/discovery/index.d.ts

@@ -6,11 +6,9 @@ export declare class DiscoveryClient {
   resolveEvidenceTypes(request: any): Promise<any>
   searchServices(filters: any): Promise<any>
   searchEvidenceServices(query: any): Promise<any>
-  searchRelayServices(query: any): Promise<any>
   selectExact(response: any, request: any): any
   selectEvidenceAlternative(response: any, evidenceTypeListId?: string | undefined | null): any
   selectEvidenceService(response: any, request: any): any
-  selectRelayService(response: any, request: any): any
 }
 
 export interface DiscoveryClientOptions {
@@ -29,8 +27,6 @@ export declare function selectEvidenceService(response: any, request: any): any
 
 export declare function selectExact(response: any, request: any): any
 
-export declare function selectRelayService(response: any, request: any): any
-
 export declare function validateSelection(selection: any): any
 
 export declare function validateSelectionStructure(selection: any): any

package/index.d.ts

@@ -1,8 +1,7 @@
 import * as discovery from './discovery/client'
 import * as evidence from './evidence/client'
-import * as relay from './relay/client'
 import * as breg from './breg/client'
 import * as casework from './casework/client'
 import * as messaging from './messaging/client'
 
-export { discovery, evidence, relay, breg, casework, messaging }
+export { discovery, evidence, breg, casework, messaging }

package/index.js

@@ -2,10 +2,9 @@
 
 // One assignment per namespace, never a `module.exports` object literal: Node
 // scans this file for these statements to synthesise the named exports an ESM
-// consumer imports, and `require()` sees the same six properties either way.
+// consumer imports, and `require()` sees the same five properties either way.
 exports.discovery = require('./discovery/client');
 exports.evidence = require('./evidence/client');
-exports.relay = require('./relay/client');
 exports.breg = require('./breg/client');
 exports.casework = require('./casework/client');
 exports.messaging = require('./messaging/client');

package/native.js

@@ -1,7 +1,7 @@
 'use strict';
 
-const PACKAGE_VERSION = '0.38.0';
-const PRODUCTS = new Set(['discovery', 'evidence', 'relay', 'breg', 'casework', 'messaging']);
+const PACKAGE_VERSION = '0.39.0';
+const PRODUCTS = new Set(['discovery', 'evidence', 'breg', 'casework', 'messaging']);
 
 function target() {
   if (process.platform === 'darwin' && process.arch === 'arm64') return 'darwin-arm64';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@registrystack/client",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Unified Node.js client for Registry Stack products.",
   "license": "Apache-2.0",
   "homepage": "https://docs.registrystack.org/reference/client-api/",
@@ -12,7 +12,6 @@
     "registrystack",
     "discovery",
     "evidence",
-    "relay",
     "breg",
     "casework",
     "messaging"
@@ -40,7 +39,6 @@
     "native.js",
     "discovery",
     "evidence",
-    "relay",
     "breg",
     "casework",
     "messaging"
@@ -59,8 +57,8 @@
     "typescript": "6.0.3"
   },
   "optionalDependencies": {
-    "@registrystack/client-darwin-arm64": "0.38.0",
-    "@registrystack/client-linux-arm64-gnu": "0.38.0",
-    "@registrystack/client-linux-x64-gnu": "0.38.0"
+    "@registrystack/client-darwin-arm64": "0.39.0",
+    "@registrystack/client-linux-arm64-gnu": "0.39.0",
+    "@registrystack/client-linux-x64-gnu": "0.39.0"
   }
 }

package/relay/client.d.ts

@@ -1,460 +0,0 @@
-export type JsonScalar = string | number | boolean | null
-export type JsonValue = JsonScalar | ReadonlyArray<JsonValue> | { readonly [key: string]: JsonValue }
-/** An integer that satisfies `Number.isSafeInteger` and the option's documented bounds. */
-export type SafeInteger = number
-
-export interface PrivateJwk {
-  readonly kty: string
-  readonly kid: string
-  readonly alg: string
-  readonly [member: string]: JsonValue
-}
-
-export interface PrivateKeyJwtConfig {
-  tokenEndpoint: string
-  clientId: string
-  clientKey: PrivateJwk
-  /**
-   * The audience of the client assertion (who checks the client's
-   * authentication). Defaults to the token endpoint URL. This is not the
-   * `resource` of the token request.
-   */
-  audience?: string | null
-  /**
-   * The RFC 8707 resource indicator the token is requested for: the resource
-   * server's registered identifier, not a URL to fetch.
-   */
-  resource?: string | null
-  /**
-   * The scopes requested for the token, sent as one space-delimited `scope`
-   * parameter. A requested scope may narrow the client's registered
-   * permission set; it can never widen it.
-   */
-  scopes?: ReadonlyArray<string> | null
-  assertionLifetimeSeconds?: SafeInteger | null
-  refreshMarginSeconds?: SafeInteger | null
-  requestTimeoutMilliseconds?: SafeInteger | null
-  connectTimeoutMilliseconds?: SafeInteger | null
-  userAgent?: string | null
-  trustedRootCertificates?: string | null
-}
-
-/** One immutable verified person or grant context. Reconstruct after host source facts change. */
-export interface ExchangeContext {
-  issuer: string
-  subject: string
-  audience: string
-  generation: string
-  deadlineSeconds: SafeInteger
-  grantId?: string | null
-}
-
-export type ExchangePrivateKeyJwtConfig = PrivateKeyJwtConfig & {
-  resource: string
-  scopes: ReadonlyArray<string>
-}
-
-export interface FirstPartyExchangeSource {
-  key: PrivateJwk
-  attributes: Readonly<Record<string, JsonValue>>
-}
-
-export interface RemoteExchangeSource {
-  endpoint: string
-  bootstrap: ExchangePrivateKeyJwtConfig
-  bootstrapResource: string
-  bootstrapScope: string
-  requestTimeoutMilliseconds?: SafeInteger | null
-  connectTimeoutMilliseconds?: SafeInteger | null
-  userAgent?: string | null
-  trustedRootCertificates?: string | null
-}
-
-export type ExchangeAuthorizationConfig =
-  | { client: ExchangePrivateKeyJwtConfig; context: ExchangeContext; firstParty: FirstPartyExchangeSource }
-  | { client: ExchangePrivateKeyJwtConfig; context: ExchangeContext; remote: RemoteExchangeSource }
-
-export type RelayAuthorization =
-  | { static: string }
-  | { privateKeyJwt: PrivateKeyJwtConfig }
-  | { exchange: ExchangeAuthorizationConfig }
-
-export interface RelayClientConfig {
-  baseUrl: string
-  authorization?: RelayAuthorization | null
-  requestTimeoutMilliseconds?: SafeInteger | null
-  connectTimeoutMilliseconds?: SafeInteger | null
-  userAgent?: string | null
-  maxResponseBytes?: SafeInteger | null
-  trustedRootCertificates?: string | null
-}
-
-export type RecordFormat = 'json' | 'json-ld' | 'geojson' | 'json-fg'
-
-export interface ResourceListOptions {
-  pageSize?: SafeInteger | null
-}
-
-export interface ResourceContinuation {
-  cursor: string
-}
-
-export interface RecordOptions {
-  fields?: ReadonlyArray<string> | null
-  accessProfile?: string | null
-  format?: RecordFormat | null
-}
-
-export interface ListOptions extends RecordOptions {
-  pageSize?: SafeInteger | null
-  filters?: Readonly<Record<string, string>> | null
-}
-
-export interface SearchOptions extends RecordOptions {
-  pageSize?: SafeInteger | null
-  /** `[west, south, east, north]` in WGS84 longitude/latitude degrees. */
-  bbox: readonly [number, number, number, number]
-}
-
-export type LookupSelector = string | SafeInteger | boolean
-export type LookupSelectors = Readonly<Record<string, LookupSelector>>
-
-export interface RecordsRoute {
-  kind: 'records'
-  resource: string
-}
-
-export interface SearchRoute {
-  kind: 'search'
-  resource: string
-  search: string
-}
-
-export interface CollectionContinuation<Route extends RecordsRoute | SearchRoute = RecordsRoute | SearchRoute> {
-  route: Route
-  cursor: string
-  format: 'json' | 'json-ld' | 'geojson-rfc7946' | 'json-fg'
-  accessProfile?: string
-}
-
-export interface SdmxDataRequest {
-  agency: string
-  resource: string
-  /** A three-part `x.y.z` SDMX version. */
-  version: string
-  key?: string | null
-  constraints?: Readonly<Record<string, string>> | null
-  offset?: SafeInteger | null
-  limit?: SafeInteger | null
-  dimensionAtObservation?: string | null
-  format?: 'json' | 'csv' | null
-}
-
-export interface SdmxStructureRequest {
-  kind: 'dataflow' | 'datastructure'
-  agency: string
-  resource: string
-  /** A three-part `x.y.z` SDMX version. */
-  version: string
-}
-
-export interface ProbeStatus {
-  status: string
-}
-
-export interface Institution {
-  identifier: string
-  name: string
-}
-
-export interface Product {
-  name: string
-  version: string
-}
-
-export interface ApiBinding {
-  name: string
-  version: string
-}
-
-export interface AlignmentTarget {
-  name: string
-  version: string
-  status: string
-  cfrTarget?: string
-}
-
-export interface FormatProfileCapability {
-  id: string
-  uri: string
-  crs: string
-  conformsTo: ReadonlyArray<string>
-}
-
-export interface WireFormatCapability {
-  id: string
-  mediaType: string
-  formatProfiles: ReadonlyArray<FormatProfileCapability>
-}
-
-export interface BboxCapability {
-  crs: string
-  predicate: string
-  maximumLongitudeSpanDegrees: number
-  maximumLatitudeSpanDegrees: number
-}
-
-export interface SpatialQueryCapability {
-  bbox: BboxCapability
-}
-
-export interface ConsultationCapability {
-  family: 'consultation'
-  pattern: string
-  resourceIdentifier: string
-  operationIdentifier: string
-  accessProfileIdentifier: string
-  isDefault: boolean
-  disclosureProfile: string
-  schemaReference: string
-  semanticModelReference: string
-  contextReference: string
-  href: string
-  wireFormats: ReadonlyArray<WireFormatCapability>
-  spatialQuery?: SpatialQueryCapability
-  classificationReference?: string
-  processingReference?: string
-}
-
-export interface SdmxProfile {
-  sdmxRestVersion: string
-  sdmxDataJsonVersion: string
-  sdmxDataCsvVersion: string
-  sdmxStructureJsonVersion: string
-}
-
-export interface SdmxWireFormat {
-  id: string
-  mediaType: string
-}
-
-export interface SdmxStructureLinks {
-  dataflow: string
-  datastructure: string
-}
-
-export interface AggregateDataCapability {
-  family: 'aggregate-data'
-  pattern: string
-  statisticalDatasetIdentifier: string
-  operationIdentifier: string
-  profile: SdmxProfile
-  wireFormats: ReadonlyArray<SdmxWireFormat>
-  href: string
-  structureLinks: SdmxStructureLinks
-}
-
-export type Capability = ConsultationCapability | AggregateDataCapability
-
-export interface ServiceMetadata {
-  registryIdentifier: string
-  name: string
-  authority: Institution
-  operator: Institution | null
-  authoritativeScope: string
-  product: Product
-  apiBinding: ApiBinding
-  alignmentTargets: ReadonlyArray<AlignmentTarget>
-  capabilities: ReadonlyArray<Capability>
-  links: { self: string; resources: string; openapi: string }
-}
-
-export interface ResourceDocument {
-  resourceIdentifier: string
-  title: string
-  description: string
-  semanticClass: string
-  enumerationPosture: string
-  capabilities: ReadonlyArray<Capability>
-  links: { self: string }
-}
-
-export interface CursorPageInfo {
-  nextCursor: string | null
-}
-
-export interface RegistryMetadata {
-  registryIdentifier: string
-}
-
-export interface ResourceCollection {
-  items: ReadonlyArray<ResourceDocument>
-  pageInfo: CursorPageInfo
-  meta: RegistryMetadata
-}
-
-export interface ResourceEnvelope {
-  data: ResourceDocument
-  meta: RegistryMetadata
-}
-
-export interface RegistryRecord {
-  registryIdentifier: string
-  recordIdentifier: string
-  revisionIdentifier: string
-  lifecycleState: string
-  schemaReference: string
-  semanticModelReference: string
-  authorityIdentifier: string
-  recordedAt: string
-  domainData: Readonly<Record<string, JsonValue>>
-  '@id'?: string
-  '@type'?: string
-}
-
-export interface SourceRevision {
-  profile: string
-  status: string
-  value: string | null
-}
-
-export interface RecordLinks {
-  self: string
-  context: string
-  schema: string
-  semanticModel: string
-}
-
-export interface RecordMetadata {
-  operationIdentifier: string
-  accessProfile: string
-  family: string
-  pattern: string
-  disclosureProfile: string
-  contractRevision: string
-  sourceRevision: SourceRevision
-  selectedFields: ReadonlyArray<string>
-  links: RecordLinks
-}
-
-export interface RecordEnvelope {
-  data: RegistryRecord
-  meta: RecordMetadata
-  '@context'?: string
-}
-
-export interface RecordCollection {
-  items: ReadonlyArray<RegistryRecord>
-  pageInfo: CursorPageInfo
-  meta: RecordMetadata
-  '@context'?: string
-}
-
-export interface GeoJsonFeature {
-  type: string
-  id: string
-  geometry: JsonValue
-  properties: RegistryRecord
-  meta?: RecordMetadata
-  conformsTo?: ReadonlyArray<string>
-  featureType?: string
-  coordRefSys?: string
-}
-
-export interface GeoJsonFeatureCollection {
-  type: string
-  features: ReadonlyArray<GeoJsonFeature>
-  pageInfo: CursorPageInfo
-  meta: RecordMetadata
-  conformsTo?: ReadonlyArray<string>
-  featureType?: string
-  coordRefSys?: string
-}
-
-export type RecordResponse = RecordEnvelope | GeoJsonFeature
-export type RecordCollectionResponse = RecordCollection | GeoJsonFeatureCollection
-
-export interface CompleteOutcome<T> {
-  kind: 'complete'
-  value: T
-  traceId: string
-  etag?: string
-}
-
-export interface NotModifiedOutcome {
-  kind: 'notModified'
-  etag: string
-  traceId: string
-}
-
-export type Outcome<T> = CompleteOutcome<T> | NotModifiedOutcome
-
-export interface ResourcePageCompleteOutcome {
-  kind: 'complete'
-  value: ResourceCollection
-  continuation?: ResourceContinuation
-  traceId: string
-  etag?: string
-}
-
-export type ResourcePageOutcome = ResourcePageCompleteOutcome | NotModifiedOutcome
-
-export interface CollectionPageCompleteOutcome {
-  kind: 'complete'
-  value: RecordCollectionResponse
-  continuation?: CollectionContinuation
-  traceId: string
-  etag?: string
-}
-
-export type CollectionPageOutcome = CollectionPageCompleteOutcome | NotModifiedOutcome
-
-export interface RawCompleteOutcome {
-  kind: 'complete'
-  body: Buffer
-  mediaType: string
-  traceId: string
-  etag?: string
-}
-
-export type RawOutcome = RawCompleteOutcome | NotModifiedOutcome
-
-export interface RelayClientFailure extends Error {
-  readonly kind: string
-  readonly code?: string
-  readonly status?: number
-  readonly traceId?: string
-  readonly retryAfterSeconds?: number
-  readonly transportKind?: string
-  readonly tokenKind?: string
-}
-
-export declare class RelayClientError extends Error implements RelayClientFailure {
-  readonly kind: string
-  readonly code?: string
-  readonly status?: number
-  readonly traceId?: string
-  readonly retryAfterSeconds?: number
-  readonly transportKind?: string
-  readonly tokenKind?: string
-}
-
-export declare class RelayClient {
-  constructor(config: RelayClientConfig)
-  health(): Promise<CompleteOutcome<ProbeStatus>>
-  ready(): Promise<CompleteOutcome<ProbeStatus>>
-  openapi(etag?: string | null): Promise<RawOutcome>
-  serviceMetadata(etag?: string | null): Promise<Outcome<ServiceMetadata>>
-  resources(options?: ResourceListOptions | null, etag?: string | null): Promise<ResourcePageOutcome>
-  continueResources(continuation: ResourceContinuation, etag?: string | null): Promise<ResourcePageOutcome>
-  resource(resource: string, etag?: string | null): Promise<Outcome<ResourceEnvelope>>
-  listRecords(resource: string, options?: ListOptions | null, etag?: string | null): Promise<CollectionPageOutcome>
-  continueListRecords(continuation: CollectionContinuation<RecordsRoute>, etag?: string | null): Promise<CollectionPageOutcome>
-  readRecord(resource: string, recordIdentifier: string, options?: RecordOptions | null, etag?: string | null): Promise<Outcome<RecordResponse>>
-  lookup(resource: string, lookup: string, selectors: LookupSelectors, options?: RecordOptions | null, etag?: string | null): Promise<Outcome<RecordResponse>>
-  search(resource: string, search: string, options: SearchOptions, etag?: string | null): Promise<CollectionPageOutcome>
-  continueSearch(continuation: CollectionContinuation<SearchRoute>, etag?: string | null): Promise<CollectionPageOutcome>
-  artifact(artifactIdentifier: string, etag?: string | null): Promise<RawOutcome>
-  sdmxData(request: SdmxDataRequest, etag?: string | null): Promise<RawOutcome>
-  sdmxStructure(request: SdmxStructureRequest, etag?: string | null): Promise<RawOutcome>
-}

package/relay/client.js

@@ -1,172 +0,0 @@
-'use strict';
-
-const { types: { isProxy } } = require('node:util');
-const native = require('./index');
-
-const MAX_JSON_DEPTH = 128;
-const MAX_JSON_NODES = 100_000;
-const MAX_JSON_STRING_BYTES = 4 * 1024 * 1024;
-
-class RelayClientError extends Error {
-  constructor(envelope) {
-    super(envelope.message);
-    this.name = 'RelayClientError';
-    this.kind = envelope.kind;
-    for (const field of ['code', 'status', 'traceId', 'retryAfterSeconds', 'transportKind', 'tokenKind']) {
-      if (envelope[field] !== undefined && envelope[field] !== null) this[field] = envelope[field];
-    }
-  }
-}
-
-function normalize(error, fallbackKind) {
-  if (error instanceof RelayClientError) return error;
-  if (error instanceof Error && typeof error.message === 'string') {
-    try {
-      const envelope = JSON.parse(error.message);
-      if (envelope && typeof envelope === 'object' && typeof envelope.kind === 'string') {
-        return new RelayClientError(envelope);
-      }
-    } catch {
-      // napi argument conversion errors are not mapped Rust error envelopes.
-    }
-  }
-  if (fallbackKind) {
-    return new RelayClientError({
-      kind: fallbackKind,
-      message: fallbackKind === 'configuration'
-        ? 'Relay client configuration is invalid'
-        : 'Relay client arguments are invalid',
-    });
-  }
-  return error;
-}
-
-function inputError(kind) {
-  return new RelayClientError({
-    kind,
-    message: kind === 'configuration'
-      ? 'Relay client configuration is invalid'
-      : 'Relay client arguments are invalid',
-  });
-}
-
-function chargeString(value, budget, kind) {
-  budget.stringBytes += Buffer.byteLength(value, 'utf8');
-  if (budget.stringBytes > MAX_JSON_STRING_BYTES) throw inputError(kind);
-}
-
-function cloneJson(value, budget, depth, allowUndefined, kind) {
-  if (depth > MAX_JSON_DEPTH) throw inputError(kind);
-  budget.nodes += 1;
-  if (budget.nodes > MAX_JSON_NODES) throw inputError(kind);
-
-  if (value === undefined) {
-    if (allowUndefined) return undefined;
-    throw inputError(kind);
-  }
-  if (value === null || typeof value === 'boolean') return value;
-  if (typeof value === 'string') {
-    chargeString(value, budget, kind);
-    return value;
-  }
-  if (typeof value === 'number') {
-    if (!Number.isFinite(value)) throw inputError(kind);
-    return value;
-  }
-  if (typeof value !== 'object' || isProxy(value)) throw inputError(kind);
-
-  const prototype = Object.getPrototypeOf(value);
-  const array = Array.isArray(value);
-  if (array ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) {
-    throw inputError(kind);
-  }
-  if (budget.active.has(value)) throw inputError(kind);
-  budget.active.add(value);
-
-  try {
-    const keys = Reflect.ownKeys(value);
-    if (keys.some((key) => typeof key === 'symbol')) throw inputError(kind);
-
-    if (array) {
-      if (value.length + budget.nodes > MAX_JSON_NODES) throw inputError(kind);
-      const clone = new Array(value.length);
-      let elementCount = 0;
-      for (const key of keys) {
-        const descriptor = Object.getOwnPropertyDescriptor(value, key);
-        if (!descriptor || !Object.hasOwn(descriptor, 'value')) throw inputError(kind);
-        if (key === 'length') continue;
-        chargeString(key, budget, kind);
-        const index = Number(key);
-        if (!descriptor.enumerable || !Number.isInteger(index) || index < 0
-          || index >= value.length || String(index) !== key) {
-          throw inputError(kind);
-        }
-        clone[index] = cloneJson(descriptor.value, budget, depth + 1, false, kind);
-        elementCount += 1;
-      }
-      if (elementCount !== value.length) throw inputError(kind);
-      return clone;
-    }
-
-    const clone = Object.create(null);
-    for (const key of keys) {
-      chargeString(key, budget, kind);
-      const descriptor = Object.getOwnPropertyDescriptor(value, key);
-      if (!descriptor || !Object.hasOwn(descriptor, 'value')) throw inputError(kind);
-      if (!descriptor.enumerable) continue;
-      clone[key] = cloneJson(descriptor.value, budget, depth + 1, false, kind);
-    }
-    return clone;
-  } finally {
-    budget.active.delete(value);
-  }
-}
-
-function cloneArguments(args, kind, requiredJsonArguments = new Set()) {
-  const budget = { nodes: 0, stringBytes: 0, active: new WeakSet() };
-  return args.map((value, index) => (
-    cloneJson(value, budget, 0, !requiredJsonArguments.has(index), kind)
-  ));
-}
-
-function wrapAsync(prototype, name, requiredJsonArguments) {
-  const original = prototype[name];
-  prototype[name] = function (...args) {
-    try {
-      const clonedArgs = cloneArguments(args, 'invalid_request', requiredJsonArguments);
-      return original.apply(this, clonedArgs).catch((error) => { throw normalize(error); });
-    } catch (error) {
-      throw normalize(error, 'invalid_request');
-    }
-  };
-}
-
-const METHODS = [
-  'health', 'ready', 'openapi', 'serviceMetadata', 'resources', 'continueResources', 'resource',
-  'listRecords', 'continueListRecords', 'readRecord', 'lookup', 'search', 'continueSearch',
-  'artifact', 'sdmxData', 'sdmxStructure',
-];
-const REQUIRED_JSON_ARGUMENTS = {
-  continueResources: new Set([0]),
-  continueListRecords: new Set([0]),
-  lookup: new Set([2]),
-  search: new Set([2]),
-  continueSearch: new Set([0]),
-  sdmxData: new Set([0]),
-  sdmxStructure: new Set([0]),
-};
-for (const method of METHODS) {
-  wrapAsync(native.RelayClient.prototype, method, REQUIRED_JSON_ARGUMENTS[method]);
-}
-
-class RelayClient extends native.RelayClient {
-  constructor(config) {
-    try {
-      super(...cloneArguments([config], 'configuration', new Set([0])));
-    } catch (error) {
-      throw normalize(error, 'configuration');
-    }
-  }
-}
-
-module.exports = { RelayClient, RelayClientError };

package/relay/index.d.ts

@@ -1,59 +0,0 @@
-/* auto-generated by NAPI-RS */
-/* eslint-disable */
-
-export declare class RelayClient {
-  constructor(configValue: any)
-  health(): Promise<CompleteOutcome>
-  ready(): Promise<CompleteOutcome>
-  openapi(etag?: string | undefined | null): Promise<RawCompleteOutcome | NotModifiedOutcome>
-  serviceMetadata(etag?: string | undefined | null): Promise<CompleteOutcome | NotModifiedOutcome>
-  resources(options?: any | undefined | null, etag?: string | undefined | null): Promise<ResourcePageOutcome | NotModifiedOutcome>
-  continueResources(continuation: any, etag?: string | undefined | null): Promise<ResourcePageOutcome | NotModifiedOutcome>
-  resource(resource: string, etag?: string | undefined | null): Promise<CompleteOutcome | NotModifiedOutcome>
-  listRecords(resource: string, options?: any | undefined | null, etag?: string | undefined | null): Promise<CollectionPageOutcome | NotModifiedOutcome>
-  continueListRecords(continuation: any, etag?: string | undefined | null): Promise<CollectionPageOutcome | NotModifiedOutcome>
-  readRecord(resource: string, recordIdentifier: string, options?: any | undefined | null, etag?: string | undefined | null): Promise<CompleteOutcome | NotModifiedOutcome>
-  lookup(resource: string, lookup: string, selectors: any, options?: any | undefined | null, etag?: string | undefined | null): Promise<CompleteOutcome | NotModifiedOutcome>
-  search(resource: string, search: string, options: any, etag?: string | undefined | null): Promise<CollectionPageOutcome | NotModifiedOutcome>
-  continueSearch(continuation: any, etag?: string | undefined | null): Promise<CollectionPageOutcome | NotModifiedOutcome>
-  artifact(artifactIdentifier: string, etag?: string | undefined | null): Promise<RawCompleteOutcome | NotModifiedOutcome>
-  sdmxData(requestValue: any, etag?: string | undefined | null): Promise<RawCompleteOutcome | NotModifiedOutcome>
-  sdmxStructure(requestValue: any, etag?: string | undefined | null): Promise<RawCompleteOutcome | NotModifiedOutcome>
-}
-
-export interface CollectionPageOutcome {
-  kind: string
-  value: any
-  continuation?: any
-  traceId: string
-  etag?: string
-}
-
-export interface CompleteOutcome {
-  kind: string
-  value: any
-  traceId: string
-  etag?: string
-}
-
-export interface NotModifiedOutcome {
-  kind: string
-  etag: string
-  traceId: string
-}
-
-export interface RawCompleteOutcome {
-  kind: string
-  body: Buffer
-  mediaType: string
-  traceId: string
-  etag?: string
-}
-
-export interface ResourcePageOutcome {
-  kind: string
-  value: any
-  continuation?: any
-  traceId: string
-  etag?: string
-}

package/relay/index.js

@@ -1,3 +0,0 @@
-'use strict';
-
-module.exports = require('../native').load('relay');