ochre-sdk 1.0.58 → 1.0.61

package/dist/constants.d.mts

@@ -1,5 +1,4 @@
 import { X2jOptions } from "fast-xml-parser";
-
 //#region src/constants.d.ts
 declare const XML_ARRAY_TAGS: ReadonlyArray<string>;
 declare const XML_PARSER_OPTIONS: X2jOptions;

package/dist/fetchers/gallery.d.mts

@@ -1,6 +1,5 @@
 import { Gallery } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/gallery.d.ts
 /**
  * Fetches and parses a gallery from the OCHRE API

package/dist/fetchers/item-children.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemContainerCategory, SetItemCategory, TreeItemCategory } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/item-children.d.ts
 type FetchItemChildrenResult<TItems> = Promise<{
   items: TItems;

package/dist/fetchers/item-links.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemContainerCategory } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/item-links.d.ts
 /**
  * Fetches linked OCHRE items by source-item UUID.

package/dist/fetchers/item.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemWithoutEmbeddedItems } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/item.d.ts
 type FetchItemResult<TItem> = Promise<{
   item: TItem;

package/dist/fetchers/set/items.d.mts

@@ -1,6 +1,5 @@
 import { Query, SetItem, SetItemCategory, SetItemsSort } from "../../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../../parsers/helpers.mjs";
-
 //#region src/fetchers/set/items.d.ts
 type FetchSetItemsCategory<TContainedItemCategories extends ReadonlyArray<SetItemCategory> | undefined> = TContainedItemCategories extends ReadonlyArray<infer U> ? Extract<U, SetItemCategory> : SetItemCategory;
 /**

package/dist/fetchers/set/property-values.d.mts

@@ -1,5 +1,4 @@
 import { PropertyValueQueryItem, Query, SetAttributeValueQueryItem } from "../../types/index.mjs";
-
 //#region src/fetchers/set/property-values.d.ts
 /**
  * Fetches and parses Set property values from the OCHRE API

package/dist/fetchers/website-metadata.d.mts

@@ -1,6 +1,5 @@
 import { WebsiteMetadata } from "../types/website.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/website-metadata.d.ts
 /**
  * Fetches and parses a page-scoped website metadata projection from the OCHRE

package/dist/fetchers/website.d.mts

@@ -1,23 +1,36 @@
-import { Website } from "../types/website.mjs";
+import { ProtectedWebsite, Website } from "../types/website.mjs";
 import { LanguageCodes } from "../types/index.mjs";
 import { FetchFunction } from "../parsers/helpers.mjs";
-
 //#region src/fetchers/website.d.ts
 /**
- * Fetches and parses a website configuration from the OCHRE API
+ * Fetches and parses a website configuration from the OCHRE API.
  *
- * @param abbreviation - The abbreviation identifier for the website
- * @returns The parsed website configuration or null if the fetch/parse fails
+ * For password-protected or OCHRE-credential-protected websites, if no credentials
+ * are provided the function returns a minimal `protectedWebsite` object instead of
+ * the full website. Pass `credentials` (a shared password string, or an object with
+ * `username` and `password` for OCHRE accounts) to authenticate and receive the full
+ * website data.
  */
 declare function fetchWebsite<const T extends LanguageCodes = LanguageCodes>(abbreviation: string, options?: {
   fetch?: FetchFunction;
   languages?: T;
+  credentials?: string | {
+    username: string;
+    password: string;
+  };
 }): Promise<{
   website: Website<T>;
+  protectedWebsite: null;
   error: null;
   detailedError: null;
 } | {
   website: null;
+  protectedWebsite: ProtectedWebsite<T>;
+  error: null;
+  detailedError: null;
+} | {
+  website: null;
+  protectedWebsite: null;
   error: string;
   detailedError: string;
 }>;

package/dist/fetchers/website.mjs

@@ -6,30 +6,64 @@ import { parseWebsite } from "../parsers/website/index.mjs";
 import * as v from "valibot";
 import { XMLParser } from "fast-xml-parser";
 //#region src/fetchers/website.ts
+async function validateWebsiteCredentials(uuid, credentials, fetcher) {
+	const security = typeof credentials === "string" ? { validate: credentials } : {
+		validate: credentials.password,
+		userOCHRE: credentials.username
+	};
+	return (await fetcher("https://ochre.lib.uchicago.edu/ochre/v2/ochre.php", {
+		method: "POST",
+		body: JSON.stringify({
+			uuid,
+			data: { security }
+		}),
+		headers: { "Content-Type": "application/json" }
+	})).ok;
+}
 /**
-* Fetches and parses a website configuration from the OCHRE API
+* Fetches and parses a website configuration from the OCHRE API.
 *
-* @param abbreviation - The abbreviation identifier for the website
-* @returns The parsed website configuration or null if the fetch/parse fails
+* For password-protected or OCHRE-credential-protected websites, if no credentials
+* are provided the function returns a minimal `protectedWebsite` object instead of
+* the full website. Pass `credentials` (a shared password string, or an object with
+* `username` and `password` for OCHRE accounts) to authenticate and receive the full
+* website data.
 */
 async function fetchWebsite(abbreviation, options) {
 	try {
+		const fetcher = options?.fetch ?? fetch;
 		const cleanAbbreviation = abbreviation.trim().toLocaleLowerCase("en-US");
-		const response = await (options?.fetch ?? fetch)(`https://ochre.lib.uchicago.edu/ochre/v2/ochre.php?xquery=${encodeURIComponent(`collection('ochre/tree')/ochre[tree/identification/abbreviation/content/string='${cleanAbbreviation}']`)}&xsl=none&lang="*"`);
+		const response = await fetcher(`https://ochre.lib.uchicago.edu/ochre/v2/ochre.php?xquery=${encodeURIComponent(`collection('ochre/tree')/ochre[tree/identification/abbreviation/content/string='${cleanAbbreviation}']`)}&xsl=none&lang="*"`);
 		if (!response.ok) throw new Error("Failed to fetch website", { cause: response.statusText });
 		const dataRaw = await response.text();
 		const data = new XMLParser(XML_PARSER_OPTIONS).parse(dataRaw);
 		const { success, issues, output } = v.safeParse(XMLWebsiteData, data);
 		if (!success) throw createSchemaValidationError("Failed to parse website XML", issues);
 		restoreXMLMetadata(output, data);
+		const website = parseWebsite(output, { languages: options?.languages });
+		if (website.properties.privacy !== "public") {
+			if (options?.credentials == null) return {
+				website: null,
+				protectedWebsite: {
+					uuid: website.uuid,
+					identification: website.identification,
+					properties: { privacy: website.properties.privacy }
+				},
+				error: null,
+				detailedError: null
+			};
+			if (!await validateWebsiteCredentials(website.uuid, options.credentials, fetcher)) throw new Error("Invalid credentials for protected website");
+		}
 		return {
-			website: parseWebsite(output, { languages: options?.languages }),
+			website,
+			protectedWebsite: null,
 			error: null,
 			detailedError: null
 		};
 	} catch (error) {
 		return {
 			website: null,
+			protectedWebsite: null,
 			...getErrorOutput(error, "Unknown error")
 		};
 	}

package/dist/getters.d.mts

@@ -1,11 +1,12 @@
 import { LanguageCodes, Property, PropertyLike, PropertyValueContent, SetItemProperty, SetItemSimplifiedProperty, SimplifiedProperty } from "./types/index.mjs";
-
 //#region src/getters.d.ts
 /**
  * Options for property search operations.
  */
 type PropertyOptions = {
-  /** Whether to recursively search through nested properties. */includeNestedProperties?: boolean; /** Whether to limit property values to leaf values. */
+  /** Whether to recursively search through nested properties. */
+  includeNestedProperties?: boolean;
+  /** Whether to limit property values to leaf values. */
   limitToLeafPropertyValues?: boolean;
 };
 type PropertyContent<T extends LanguageCodes> = PropertyValueContent<T>["content"];

package/dist/helpers.d.mts

@@ -1,5 +1,4 @@
 import { ContainedItemCategory, Item, ItemCategory, ItemPayloadKind, LanguageCodes, SetItemProperty } from "./types/index.mjs";
-
 //#region src/helpers.d.ts
 type FlattenedItem<U, T extends LanguageCodes> = Omit<U, "properties"> & {
   properties: Array<SetItemProperty<T>>;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { MultilingualOptions, MultilingualString, MultilingualStringEntries, MultilingualStringEntry, MultilingualStringInput, MultilingualStringJSON, MultilingualStringObject, MultilingualStringText } from "./parsers/multilingual.mjs";
-import { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebImage, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
+import { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebImage, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
 import { AnyBibliography, AnyConcept, AnyItem, AnyPeriod, AnyPerson, AnyPropertyValue, AnyPropertyVariable, AnyResource, AnySet, AnySpatialUnit, AnyText, AnyTree, BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, ContainedItemCategory, ContainedItemCategoryFromOption, ContainedItemCategoryOption, Context, ContextItem, ContextItemCategory, ContextNode, Coordinates, CoordinatesSource, DictionaryUnitItemLink, EmbeddedBibliography, EmbeddedConcept, EmbeddedItem, EmbeddedPeriod, EmbeddedPerson, EmbeddedPropertyValue, EmbeddedPropertyVariable, EmbeddedResource, EmbeddedSet, EmbeddedSpatialUnit, EmbeddedText, EmbeddedTree, Event, Gallery, Heading, HeadingItemCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemLink, ItemLinkCategory, ItemLinks, ItemPayloadKind, ItemProperty, ItemWithoutEmbeddedItems, LanguageCodes, License, Metadata, Note, Observation, Period, PeriodItemLink, Person, PersonItemLink, Prettify, Property, PropertyLike, PropertyRelation, PropertyValue, PropertyValueContent, PropertyValueDataType, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, QueryablePropertyValueDataType, RecursiveItemCategory, Resource, ResourceItemLink, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemCategory, SetItemLink, SetItemProperty, SetItemSimplifiedProperty, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetTree, SimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Text, TextItemLink, TopLevelItem, Tree, TreeItemCategory, TreeItemLink } from "./types/index.mjs";
 import { fetchGallery } from "./fetchers/gallery.mjs";
 import { fetchItemChildren } from "./fetchers/item-children.mjs";
@@ -11,4 +11,4 @@ import { fetchWebsiteMetadata } from "./fetchers/website-metadata.mjs";
 import { fetchWebsite } from "./fetchers/website.mjs";
 import { PropertyOptions, filterProperties, getLeafPropertyValues, getPropertyByVariableLabel, getPropertyByVariableLabelAndValue, getPropertyByVariableLabelAndValueContent, getPropertyByVariableLabelAndValueContents, getPropertyByVariableLabelAndValues, getPropertyByVariableUuid, getPropertyValueByVariableLabel, getPropertyValueByVariableUuid, getPropertyValueContentByVariableLabel, getPropertyValueContentByVariableUuid, getPropertyValueContentsByVariableUuid, getPropertyValuesByVariableLabel, getPropertyValuesByVariableUuid, getUniqueProperties, getUniquePropertyVariableLabels } from "./getters.mjs";
 import { DEFAULT_PAGE_SIZE, flattenItemProperties } from "./helpers.mjs";
-export { type AccordionWebBlock, type AnyBibliography, type AnyConcept, type AnyItem, type AnyPeriod, type AnyPerson, type AnyPropertyValue, type AnyPropertyVariable, type AnyResource, type AnySet, type AnySpatialUnit, type AnyText, type AnyTree, type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type EmbeddedBibliography, type EmbeddedConcept, type EmbeddedItem, type EmbeddedPeriod, type EmbeddedPerson, type EmbeddedPropertyValue, type EmbeddedPropertyVariable, type EmbeddedResource, type EmbeddedSet, type EmbeddedSpatialUnit, type EmbeddedText, type EmbeddedTree, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Prettify, type Property, type PropertyLike, PropertyOptions, type PropertyRelation, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type RecursiveItemCategory, type Resource, type ResourceItemLink, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetCategory, type StylesheetItem, type Text, type TextItemLink, type TopLevelItem, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebImage, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, filterProperties, flattenItemProperties, getLeafPropertyValues, getPropertyByVariableLabel, getPropertyByVariableLabelAndValue, getPropertyByVariableLabelAndValueContent, getPropertyByVariableLabelAndValueContents, getPropertyByVariableLabelAndValues, getPropertyByVariableUuid, getPropertyValueByVariableLabel, getPropertyValueByVariableUuid, getPropertyValueContentByVariableLabel, getPropertyValueContentByVariableUuid, getPropertyValueContentsByVariableUuid, getPropertyValuesByVariableLabel, getPropertyValuesByVariableUuid, getUniqueProperties, getUniquePropertyVariableLabels, withLanguages };
+export { type AccordionWebBlock, type AnyBibliography, type AnyConcept, type AnyItem, type AnyPeriod, type AnyPerson, type AnyPropertyValue, type AnyPropertyVariable, type AnyResource, type AnySet, type AnySpatialUnit, type AnyText, type AnyTree, type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type EmbeddedBibliography, type EmbeddedConcept, type EmbeddedItem, type EmbeddedPeriod, type EmbeddedPerson, type EmbeddedPropertyValue, type EmbeddedPropertyVariable, type EmbeddedResource, type EmbeddedSet, type EmbeddedSpatialUnit, type EmbeddedText, type EmbeddedTree, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Prettify, type Property, type PropertyLike, PropertyOptions, type PropertyRelation, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type ProtectedWebsite, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type RecursiveItemCategory, type Resource, type ResourceItemLink, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetCategory, type StylesheetItem, type Text, type TextItemLink, type TopLevelItem, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebImage, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, filterProperties, flattenItemProperties, getLeafPropertyValues, getPropertyByVariableLabel, getPropertyByVariableLabelAndValue, getPropertyByVariableLabelAndValueContent, getPropertyByVariableLabelAndValueContents, getPropertyByVariableLabelAndValues, getPropertyByVariableUuid, getPropertyValueByVariableLabel, getPropertyValueByVariableUuid, getPropertyValueContentByVariableLabel, getPropertyValueContentByVariableUuid, getPropertyValueContentsByVariableUuid, getPropertyValuesByVariableLabel, getPropertyValuesByVariableUuid, getUniqueProperties, getUniquePropertyVariableLabels, withLanguages };

package/dist/parsers/helpers.d.mts

@@ -1,7 +1,6 @@
 import { MultilingualString } from "./multilingual.mjs";
 import { License } from "../types/index.mjs";
 import { XMLContent, XMLString } from "../xml/types.mjs";
-
 //#region src/parsers/helpers.d.ts
 type FetchFunction = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
 type FetchBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {

package/dist/parsers/index.d.mts

@@ -2,7 +2,6 @@ import { Webpage } from "../types/website.mjs";
 import { Bibliography, ContainedItemCategoryFromOption, ContainedItemCategoryOption, Gallery, Identification, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemContainerCategory, ItemLinks, Metadata, Note, Person, Property, Resource, SetItem, SetItemCategory, SimplifiedProperty } from "../types/index.mjs";
 import { XMLBibliography, XMLData, XMLDataItem, XMLGalleryData, XMLIdentification, XMLItemLinks, XMLLink, XMLMetadata, XMLNote, XMLPerson, XMLProperty, XMLResource, XMLSetItems, XMLSimplifiedProperty } from "../xml/types.mjs";
 import { ParserOptions, getParserOptions, parseStringLike } from "./helpers.mjs";
-
 //#region src/parsers/index.d.ts
 type RawOchre = XMLData["result"]["ochre"];
 type ResourceViewParser<T extends ReadonlyArray<string>> = (view: XMLResource["view"], context: Pick<Resource<T, "topLevel">, "belongsTo" | "metadata">) => Webpage<T> | null;

package/dist/parsers/multilingual.d.mts

@@ -26,8 +26,11 @@ type MultilingualStringEntries<T extends ReadonlyArray<string> = ReadonlyArray<s
  * Options for creating and working with multilingual strings
  */
 type MultilingualOptions = {
-  /** Default language to use for fallbacks */defaultLanguage?: string; /** Available languages for this string */
-  availableLanguages?: ReadonlyArray<string>; /** Alias values carried by OCHRE as zxx content */
+  /** Default language to use for fallbacks */
+  defaultLanguage?: string;
+  /** Available languages for this string */
+  availableLanguages?: ReadonlyArray<string>;
+  /** Alias values carried by OCHRE as zxx content */
   aliases?: ReadonlyArray<string>;
 };
 type MultilingualContent<T extends ReadonlyArray<string>> = Partial<Record<T[number], ReadonlyArray<MultilingualStringEntry>>>;

package/dist/parsers/string.d.mts

@@ -1,6 +1,5 @@
 import { MultilingualString, MultilingualStringText } from "./multilingual.mjs";
 import { XMLContent, XMLString } from "../xml/types.mjs";
-
 //#region src/parsers/string.d.ts
 declare function transformPermanentIdentificationUrl(url: string): string;
 declare function parseXMLString(string: XMLString): MultilingualStringText;

package/dist/parsers/website/index.d.mts

@@ -1,7 +1,6 @@
 import { Webpage, Website } from "../../types/website.mjs";
 import { XMLWebsiteData, XMLWebsiteResource } from "../../xml/types.mjs";
 import { ParserOptions } from "../helpers.mjs";
-
 //#region src/parsers/website/index.d.ts
 /**
  * Parses raw bounds data into a standardized bounds structure

package/dist/parsers/website/reader.d.mts

@@ -1,7 +1,6 @@
 import { MultilingualString } from "../multilingual.mjs";
 import { LanguageCodes, PropertyValueContent, SimplifiedProperty } from "../../types/index.mjs";
 import { ParserOptions } from "../helpers.mjs";
-
 //#region src/parsers/website/reader.d.ts
 type WebsitePropertyContent<T extends LanguageCodes> = PropertyValueContent<T>["content"];
 declare class WebsitePresentationReader<T extends LanguageCodes> {

package/dist/query.d.mts

@@ -1,5 +1,4 @@
 import { Query } from "./types/index.mjs";
-
 //#region src/query.d.ts
 declare function buildAndCtsQueryExpression(queryExpressions: Array<string>): string | null;
 declare function buildBelongsToCollectionQueryExpression(belongsToCollectionScopeUuids: Array<string>, belongsToCollectionPropertyVariableUuid: string): string | null;

package/dist/schemas.d.mts

@@ -1,6 +1,5 @@
 import { Query } from "./types/index.mjs";
 import * as v from "valibot";
-
 //#region src/schemas.d.ts
 /**
  * Schema for validating UUIDs

package/dist/types/index.d.mts

@@ -1,8 +1,7 @@
 import { MultilingualString } from "../parsers/multilingual.mjs";
 import { Webpage } from "./website.mjs";
-
 //#region src/types/index.d.ts
-type Prettify<T> = { [K in keyof T]: T[K] } & {};
+type Prettify<T> = { [K in keyof T]: T[K]; } & {};
 /**
  * Language-code tuple or array used by OCHRE multilingual fields.
  *
@@ -511,7 +510,7 @@ type Set<U extends SetItemCategory = SetItemCategory, T extends LanguageCodes =
   properties: Array<Property<T>>;
   items: Array<SetItem<U, T>>;
 }>;
-type SetBibliography<T extends LanguageCodes = LanguageCodes> = Bibliography<T, "embedded"> extends infer U ? U extends {
+type SetBibliography<T extends LanguageCodes = LanguageCodes> = Bibliography<T, "embedded"> extends (infer U) ? U extends {
   properties: Array<Property<T>>;
 } ? Prettify<Omit<U, "properties" | "items"> & {
   properties: Array<SetItemProperty<T>>;

package/dist/types/website.d.mts

@@ -1,6 +1,5 @@
 import { MultilingualString } from "../parsers/multilingual.mjs";
 import { Bibliography, Identification, ItemCategory, LanguageCodes, License, Metadata, Person, Prettify, QueryablePropertyValueDataType } from "./index.mjs";
-
 //#region src/types/website.d.ts
 /**
  * Represents a context tree level item with a variable and value
@@ -126,7 +125,7 @@ type Website<T extends LanguageCodes = LanguageCodes> = {
     type: WebsiteType;
     status: "development" | "preview" | "production";
     versionLabel: "experimental" | "alpha" | "beta" | "test" | "staging" | "pre-release" | "release";
-    privacy: "public" | "password" | "private";
+    privacy: "public" | "password" | "password-ochre";
     contact: {
       name: string;
       email: string | null;
@@ -527,5 +526,12 @@ type WebsiteMetadata<T extends LanguageCodes = LanguageCodes> = {
     };
   };
 };
+type ProtectedWebsite<T extends LanguageCodes = LanguageCodes> = {
+  uuid: string;
+  identification: Identification<T>;
+  properties: {
+    privacy: "password" | "password-ochre";
+  };
+};
 //#endregion
-export { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebImage, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType };
+export { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebImage, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType };

package/dist/utilities.d.mts

@@ -1,6 +1,5 @@
 import { LanguageCodes, Property, SetItemProperty } from "./types/index.mjs";
 import * as v from "valibot";
-
 //#region src/utilities.d.ts
 type SchemaValidationIssue = v.BaseIssue<unknown>;
 declare function getErrorOutput(error: unknown, fallbackMessage: string): {

package/dist/xml/schemas.d.mts

@@ -1,6 +1,5 @@
 import { XMLData as XMLData$1, XMLDataItem as XMLDataItem$1, XMLGalleryData as XMLGalleryData$1, XMLItemLinksData as XMLItemLinksData$1, XMLLink as XMLLink$1, XMLSetItemsData as XMLSetItemsData$1, XMLWebsiteData as XMLWebsiteData$1 } from "./types.mjs";
 import * as v from "valibot";
-
 //#region src/xml/schemas.d.ts
 declare const XMLLink: v.GenericSchema<unknown, XMLLink$1>;
 declare const XMLDataItem: v.GenericSchema<unknown, XMLDataItem$1>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "1.0.58",
+  "version": "1.0.61",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",
@@ -46,20 +46,20 @@
   ],
   "dependencies": {
     "date-fns": "^4.4.0",
-    "fast-equals": "^6.0.0",
-    "fast-xml-parser": "^5.9.3",
+    "fast-equals": "^6.0.2",
+    "fast-xml-parser": "^5.10.0",
     "valibot": "^1.4.2"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.1.0",
-    "@types/node": "^24.13.2",
+    "@types/node": "^24.13.3",
     "bumpp": "^11.1.0",
-    "eslint": "^10.6.0",
-    "knip": "^6.23.0",
-    "oxfmt": "^0.56.0",
-    "tsdown": "^0.22.3",
+    "eslint": "^10.7.0",
+    "knip": "^6.26.0",
+    "oxfmt": "^0.58.0",
+    "tsdown": "^0.22.7",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "dev": "tsdown src/index.ts --watch",