archive-codec 1.2.0 → 1.4.0

package/dist/oleps/read.js

@@ -0,0 +1,130 @@
+import { WINDOWS_1252_CODEPAGE, filetimeToDate, readGuid } from "./wire.js";
+//#region src/oleps/read.ts
+var PropertySetFormatError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetFormatError";
+	}
+};
+function requireBytes(byteLength, offset, length, what) {
+	if (offset < 0 || length < 0 || offset + length > byteLength) throw new PropertySetFormatError(`property set stream ends before ${what} (needs ${length} bytes at offset ${offset}, stream is ${byteLength} bytes)`);
+}
+const ANSI_DECODER = new TextDecoder("windows-1252");
+const UTF16_DECODER = new TextDecoder("utf-16le");
+function decodeAnsi(bytes, codepage) {
+	if (codepage !== 1252) return;
+	return ANSI_DECODER.decode(bytes);
+}
+function truncateAtNull(value) {
+	const index = value.indexOf("\0");
+	return index === -1 ? value : value.slice(0, index);
+}
+function readCodePageString(bytes, view, offset, codepage) {
+	requireBytes(bytes.length, offset, 4, "a CodePageString's Size field");
+	const size = view.getUint32(offset, true);
+	requireBytes(bytes.length, offset + 4, size, "a CodePageString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + size);
+	if (codepage === 1200) return truncateAtNull(UTF16_DECODER.decode(raw));
+	const decoded = decodeAnsi(raw, codepage);
+	return decoded === void 0 ? void 0 : truncateAtNull(decoded);
+}
+function readUnicodeString(bytes, view, offset) {
+	requireBytes(bytes.length, offset, 4, "a UnicodeString's Length field");
+	const byteLength = view.getUint32(offset, true) * 2;
+	requireBytes(bytes.length, offset + 4, byteLength, "a UnicodeString's Characters field");
+	const raw = bytes.subarray(offset + 4, offset + 4 + byteLength);
+	return truncateAtNull(UTF16_DECODER.decode(raw));
+}
+function readPropertySetStream(bytes) {
+	requireBytes(bytes.length, 0, 48, "the PropertySetStream header");
+	const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+	const byteOrder = view.getUint16(0, true);
+	if (byteOrder !== 65534) throw new PropertySetFormatError(`property set stream's ByteOrder field is 0x${byteOrder.toString(16)}, not the mandated 0xFFFE`);
+	const numPropertySets = view.getUint32(24, true);
+	if (numPropertySets !== 1) throw new PropertySetFormatError(`property set stream declares ${numPropertySets} property sets; this reader only handles the single-property-set form every "\\x05SummaryInformation" stream uses (the two-property-set DocumentSummaryInformation/UserDefinedProperties spelling is out of scope, see the package README)`);
+	const formatId = readGuid(view, 28);
+	const offset0 = view.getUint32(44, true);
+	requireBytes(bytes.length, offset0, 8, "the PropertySet packet header");
+	const size = view.getUint32(offset0, true);
+	requireBytes(bytes.length, offset0, size, "the PropertySet packet's own declared Size");
+	const numProperties = view.getUint32(offset0 + 4, true);
+	const tableStart = offset0 + 8;
+	requireBytes(bytes.length, tableStart, numProperties * 8, "the PropertyIdentifierAndOffset dictionary");
+	const entries = [];
+	for (let i = 0; i < numProperties; i++) {
+		const entryOffset = tableStart + i * 8;
+		const pid = view.getUint32(entryOffset, true);
+		if (pid === 0) throw new PropertySetFormatError("property set carries a Dictionary property (PID 0), which names string-keyed properties this reader does not support -- no \"\\x05SummaryInformation\" stream should carry one");
+		entries.push({
+			pid,
+			relativeOffset: view.getUint32(entryOffset + 4, true)
+		});
+	}
+	let codepage = WINDOWS_1252_CODEPAGE;
+	for (const entry of entries) {
+		if (entry.pid !== 1) continue;
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 8, "the CodePage property's TypedPropertyValue");
+		const type = view.getUint16(abs, true);
+		if (type !== 2) throw new PropertySetFormatError(`CodePage property (PID 1) has type 0x${type.toString(16)}, not VT_I2 as [MS-OLEPS] requires`);
+		const raw = view.getInt16(abs + 4, true);
+		codepage = raw < 0 ? raw + 65536 : raw;
+	}
+	const properties = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const abs = offset0 + entry.relativeOffset;
+		requireBytes(bytes.length, abs, 4, "a property's TypedPropertyValue header");
+		const type = view.getUint16(abs, true);
+		const padding = view.getUint16(abs + 2, true);
+		if (padding !== 0) throw new PropertySetFormatError(`property ${entry.pid}'s TypedPropertyValue padding is 0x${padding.toString(16)}, not zero as [MS-OLEPS] requires`);
+		const valueOffset = abs + 4;
+		switch (type) {
+			case 2:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I2 value`);
+				properties.set(entry.pid, {
+					type: "VT_I2",
+					value: view.getInt16(valueOffset, true)
+				});
+				break;
+			case 3:
+				requireBytes(bytes.length, valueOffset, 4, `property ${entry.pid}'s VT_I4 value`);
+				properties.set(entry.pid, {
+					type: "VT_I4",
+					value: view.getInt32(valueOffset, true)
+				});
+				break;
+			case 30: {
+				const value = readCodePageString(bytes, view, valueOffset, codepage);
+				if (value !== void 0) properties.set(entry.pid, {
+					type: "VT_LPSTR",
+					value
+				});
+				break;
+			}
+			case 31: {
+				const value = readUnicodeString(bytes, view, valueOffset);
+				properties.set(entry.pid, {
+					type: "VT_LPWSTR",
+					value
+				});
+				break;
+			}
+			case 64: {
+				requireBytes(bytes.length, valueOffset, 8, `property ${entry.pid}'s VT_FILETIME value`);
+				const low = view.getUint32(valueOffset, true);
+				const high = view.getUint32(valueOffset + 4, true);
+				properties.set(entry.pid, {
+					type: "VT_FILETIME",
+					value: filetimeToDate(low, high)
+				});
+				break;
+			}
+		}
+	}
+	return {
+		formatId,
+		properties
+	};
+}
+//#endregion
+export { PropertySetFormatError, readPropertySetStream };

package/dist/oleps/summary-information.cjs

@@ -0,0 +1,94 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_oleps_wire = require("./wire.cjs");
+const require_oleps_read = require("./read.cjs");
+const require_oleps_write = require("./write.cjs");
+//#region src/oleps/summary-information.ts
+const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+const PID_TITLE = 2;
+const PID_SUBJECT = 3;
+const PID_AUTHOR = 4;
+const PID_KEYWORDS = 5;
+const PID_COMMENTS = 6;
+const PID_LASTPRINTED = 11;
+const PID_CREATE_DTM = 12;
+const PID_LASTSAVE_DTM = 13;
+const KEYWORDS_DELIMITER = ", ";
+function splitKeywords(value) {
+	const parts = value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+	return parts.length > 0 ? parts : void 0;
+}
+function stringValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_LPSTR" && value.type !== "VT_LPWSTR") throw new require_oleps_read.PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not a string type as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	return value.value.length > 0 ? value.value : void 0;
+}
+const FILETIME_UNSET_ISO = "1601-01-01T00:00:00.000Z";
+function dateIsoValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_FILETIME") throw new require_oleps_read.PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not VT_FILETIME as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	const iso = value.value.toISOString();
+	return iso === FILETIME_UNSET_ISO ? void 0 : iso;
+}
+function readSummaryInformation(bytes) {
+	const propertySet = require_oleps_read.readPropertySetStream(bytes);
+	if (propertySet.formatId !== "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}") throw new require_oleps_read.PropertySetFormatError(`property set stream declares FMTID ${propertySet.formatId}, not FMTID_SummaryInformation (${FMTID_SUMMARY_INFORMATION}); this is not a "\\x05SummaryInformation" stream`);
+	const { properties } = propertySet;
+	const keywords = stringValue(properties.get(PID_KEYWORDS), PID_KEYWORDS);
+	return {
+		title: stringValue(properties.get(PID_TITLE), PID_TITLE),
+		subject: stringValue(properties.get(PID_SUBJECT), PID_SUBJECT),
+		author: stringValue(properties.get(PID_AUTHOR), PID_AUTHOR),
+		keywords: keywords === void 0 ? void 0 : splitKeywords(keywords),
+		comments: stringValue(properties.get(PID_COMMENTS), PID_COMMENTS),
+		createdIso: dateIsoValue(properties.get(PID_CREATE_DTM), PID_CREATE_DTM),
+		lastSavedIso: dateIsoValue(properties.get(PID_LASTSAVE_DTM), PID_LASTSAVE_DTM),
+		lastPrintedIso: dateIsoValue(properties.get(PID_LASTPRINTED), PID_LASTPRINTED)
+	};
+}
+function writeSummaryInformationStream(properties) {
+	const entries = /* @__PURE__ */ new Map();
+	entries.set(1, {
+		type: "VT_I2",
+		value: require_oleps_wire.CP_WINUNICODE
+	});
+	if (properties.title !== void 0) entries.set(PID_TITLE, {
+		type: "VT_LPWSTR",
+		value: properties.title
+	});
+	if (properties.subject !== void 0) entries.set(PID_SUBJECT, {
+		type: "VT_LPWSTR",
+		value: properties.subject
+	});
+	if (properties.author !== void 0) entries.set(PID_AUTHOR, {
+		type: "VT_LPWSTR",
+		value: properties.author
+	});
+	if (properties.keywords !== void 0 && properties.keywords.length > 0) entries.set(PID_KEYWORDS, {
+		type: "VT_LPWSTR",
+		value: properties.keywords.join(KEYWORDS_DELIMITER)
+	});
+	if (properties.comments !== void 0) entries.set(PID_COMMENTS, {
+		type: "VT_LPWSTR",
+		value: properties.comments
+	});
+	if (properties.createdIso !== void 0) entries.set(PID_CREATE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.createdIso)
+	});
+	if (properties.lastSavedIso !== void 0) entries.set(PID_LASTSAVE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastSavedIso)
+	});
+	if (properties.lastPrintedIso !== void 0) entries.set(PID_LASTPRINTED, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastPrintedIso)
+	});
+	return require_oleps_write.writePropertySetStream({
+		formatId: FMTID_SUMMARY_INFORMATION,
+		properties: entries
+	});
+}
+//#endregion
+exports.FMTID_SUMMARY_INFORMATION = FMTID_SUMMARY_INFORMATION;
+exports.readSummaryInformation = readSummaryInformation;
+exports.writeSummaryInformationStream = writeSummaryInformationStream;

package/dist/oleps/summary-information.d.cts

@@ -0,0 +1,16 @@
+//#region src/oleps/summary-information.d.ts
+declare const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+interface SummaryInformationProperties {
+  readonly title?: string;
+  readonly subject?: string;
+  readonly author?: string;
+  readonly keywords?: readonly string[];
+  readonly comments?: string;
+  readonly createdIso?: string;
+  readonly lastSavedIso?: string;
+  readonly lastPrintedIso?: string;
+}
+declare function readSummaryInformation(bytes: Uint8Array<ArrayBuffer>): SummaryInformationProperties;
+declare function writeSummaryInformationStream(properties: SummaryInformationProperties): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/summary-information.d.ts

@@ -0,0 +1,16 @@
+//#region src/oleps/summary-information.d.ts
+declare const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+interface SummaryInformationProperties {
+  readonly title?: string;
+  readonly subject?: string;
+  readonly author?: string;
+  readonly keywords?: readonly string[];
+  readonly comments?: string;
+  readonly createdIso?: string;
+  readonly lastSavedIso?: string;
+  readonly lastPrintedIso?: string;
+}
+declare function readSummaryInformation(bytes: Uint8Array<ArrayBuffer>): SummaryInformationProperties;
+declare function writeSummaryInformationStream(properties: SummaryInformationProperties): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, SummaryInformationProperties, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/summary-information.js

@@ -0,0 +1,91 @@
+import { CP_WINUNICODE } from "./wire.js";
+import { PropertySetFormatError, readPropertySetStream } from "./read.js";
+import { writePropertySetStream } from "./write.js";
+//#region src/oleps/summary-information.ts
+const FMTID_SUMMARY_INFORMATION = "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}";
+const PID_TITLE = 2;
+const PID_SUBJECT = 3;
+const PID_AUTHOR = 4;
+const PID_KEYWORDS = 5;
+const PID_COMMENTS = 6;
+const PID_LASTPRINTED = 11;
+const PID_CREATE_DTM = 12;
+const PID_LASTSAVE_DTM = 13;
+const KEYWORDS_DELIMITER = ", ";
+function splitKeywords(value) {
+	const parts = value.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+	return parts.length > 0 ? parts : void 0;
+}
+function stringValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_LPSTR" && value.type !== "VT_LPWSTR") throw new PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not a string type as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	return value.value.length > 0 ? value.value : void 0;
+}
+const FILETIME_UNSET_ISO = "1601-01-01T00:00:00.000Z";
+function dateIsoValue(value, pid) {
+	if (value === void 0) return void 0;
+	if (value.type !== "VT_FILETIME") throw new PropertySetFormatError(`SummaryInformation property ${pid} has type ${value.type}, not VT_FILETIME as [MS-OLEPS]'s SummaryInformation Property Set defines`);
+	const iso = value.value.toISOString();
+	return iso === FILETIME_UNSET_ISO ? void 0 : iso;
+}
+function readSummaryInformation(bytes) {
+	const propertySet = readPropertySetStream(bytes);
+	if (propertySet.formatId !== "{F29F85E0-4FF9-1068-AB91-08002B27B3D9}") throw new PropertySetFormatError(`property set stream declares FMTID ${propertySet.formatId}, not FMTID_SummaryInformation (${FMTID_SUMMARY_INFORMATION}); this is not a "\\x05SummaryInformation" stream`);
+	const { properties } = propertySet;
+	const keywords = stringValue(properties.get(PID_KEYWORDS), PID_KEYWORDS);
+	return {
+		title: stringValue(properties.get(PID_TITLE), PID_TITLE),
+		subject: stringValue(properties.get(PID_SUBJECT), PID_SUBJECT),
+		author: stringValue(properties.get(PID_AUTHOR), PID_AUTHOR),
+		keywords: keywords === void 0 ? void 0 : splitKeywords(keywords),
+		comments: stringValue(properties.get(PID_COMMENTS), PID_COMMENTS),
+		createdIso: dateIsoValue(properties.get(PID_CREATE_DTM), PID_CREATE_DTM),
+		lastSavedIso: dateIsoValue(properties.get(PID_LASTSAVE_DTM), PID_LASTSAVE_DTM),
+		lastPrintedIso: dateIsoValue(properties.get(PID_LASTPRINTED), PID_LASTPRINTED)
+	};
+}
+function writeSummaryInformationStream(properties) {
+	const entries = /* @__PURE__ */ new Map();
+	entries.set(1, {
+		type: "VT_I2",
+		value: CP_WINUNICODE
+	});
+	if (properties.title !== void 0) entries.set(PID_TITLE, {
+		type: "VT_LPWSTR",
+		value: properties.title
+	});
+	if (properties.subject !== void 0) entries.set(PID_SUBJECT, {
+		type: "VT_LPWSTR",
+		value: properties.subject
+	});
+	if (properties.author !== void 0) entries.set(PID_AUTHOR, {
+		type: "VT_LPWSTR",
+		value: properties.author
+	});
+	if (properties.keywords !== void 0 && properties.keywords.length > 0) entries.set(PID_KEYWORDS, {
+		type: "VT_LPWSTR",
+		value: properties.keywords.join(KEYWORDS_DELIMITER)
+	});
+	if (properties.comments !== void 0) entries.set(PID_COMMENTS, {
+		type: "VT_LPWSTR",
+		value: properties.comments
+	});
+	if (properties.createdIso !== void 0) entries.set(PID_CREATE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.createdIso)
+	});
+	if (properties.lastSavedIso !== void 0) entries.set(PID_LASTSAVE_DTM, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastSavedIso)
+	});
+	if (properties.lastPrintedIso !== void 0) entries.set(PID_LASTPRINTED, {
+		type: "VT_FILETIME",
+		value: new Date(properties.lastPrintedIso)
+	});
+	return writePropertySetStream({
+		formatId: FMTID_SUMMARY_INFORMATION,
+		properties: entries
+	});
+}
+//#endregion
+export { FMTID_SUMMARY_INFORMATION, readSummaryInformation, writeSummaryInformationStream };

package/dist/oleps/wire.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/oleps/wire.ts
+const BYTE_ORDER_MARK = 65534;
+const HEADER_SIZE = 48;
+const PROPERTY_SET_HEADER_SIZE = 8;
+const IDENTIFIER_AND_OFFSET_SIZE = 8;
+const TYPED_VALUE_HEADER_SIZE = 4;
+const VT_I2 = 2;
+const VT_I4 = 3;
+const VT_LPSTR = 30;
+const VT_LPWSTR = 31;
+const VT_FILETIME = 64;
+const PID_DICTIONARY = 0;
+const PID_CODEPAGE = 1;
+const CP_WINUNICODE = 1200;
+const WINDOWS_1252_CODEPAGE = 1252;
+const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+function hex(n, width) {
+	return n.toString(16).padStart(width, "0");
+}
+function readGuid(view, offset) {
+	const data1 = hex(view.getUint32(offset, true), 8);
+	const data2 = hex(view.getUint16(offset + 4, true), 4);
+	const data3 = hex(view.getUint16(offset + 6, true), 4);
+	let data4a = "";
+	for (let i = 0; i < 2; i++) data4a += hex(view.getUint8(offset + 8 + i), 2);
+	let data4b = "";
+	for (let i = 2; i < 8; i++) data4b += hex(view.getUint8(offset + 8 + i), 2);
+	return `{${data1}-${data2}-${data3}-${data4a}-${data4b}}`.toUpperCase();
+}
+function writeGuid(view, offset, guid) {
+	const digits = guid.replace(/[{}-]/g, "");
+	view.setUint32(offset, Number.parseInt(digits.slice(0, 8), 16), true);
+	view.setUint16(offset + 4, Number.parseInt(digits.slice(8, 12), 16), true);
+	view.setUint16(offset + 6, Number.parseInt(digits.slice(12, 16), 16), true);
+	for (let i = 0; i < 8; i++) view.setUint8(offset + 8 + i, Number.parseInt(digits.slice(16 + i * 2, 18 + i * 2), 16));
+}
+const FILETIME_EPOCH_OFFSET_100NS = 116444736000000000n;
+const HUNDRED_NS_PER_MS = 10000n;
+function filetimeToDate(low, high) {
+	const ms = ((BigInt(high) << 32n | BigInt(low)) - FILETIME_EPOCH_OFFSET_100NS) / HUNDRED_NS_PER_MS;
+	return new Date(Number(ms));
+}
+function dateToFiletime(date) {
+	const ticks = BigInt(date.getTime()) * HUNDRED_NS_PER_MS + FILETIME_EPOCH_OFFSET_100NS;
+	return {
+		low: Number(ticks & 4294967295n),
+		high: Number(ticks >> 32n & 4294967295n)
+	};
+}
+//#endregion
+exports.BYTE_ORDER_MARK = BYTE_ORDER_MARK;
+exports.CP_WINUNICODE = CP_WINUNICODE;
+exports.GUID_NULL = GUID_NULL;
+exports.HEADER_SIZE = HEADER_SIZE;
+exports.IDENTIFIER_AND_OFFSET_SIZE = IDENTIFIER_AND_OFFSET_SIZE;
+exports.PID_CODEPAGE = PID_CODEPAGE;
+exports.PID_DICTIONARY = PID_DICTIONARY;
+exports.PROPERTY_SET_HEADER_SIZE = PROPERTY_SET_HEADER_SIZE;
+exports.TYPED_VALUE_HEADER_SIZE = TYPED_VALUE_HEADER_SIZE;
+exports.VT_FILETIME = VT_FILETIME;
+exports.VT_I2 = VT_I2;
+exports.VT_I4 = VT_I4;
+exports.VT_LPSTR = VT_LPSTR;
+exports.VT_LPWSTR = VT_LPWSTR;
+exports.WINDOWS_1252_CODEPAGE = WINDOWS_1252_CODEPAGE;
+exports.dateToFiletime = dateToFiletime;
+exports.filetimeToDate = filetimeToDate;
+exports.readGuid = readGuid;
+exports.writeGuid = writeGuid;

package/dist/oleps/wire.d.cts

@@ -0,0 +1,45 @@
+//#region src/oleps/wire.d.ts
+declare const BYTE_ORDER_MARK = 65534;
+declare const HEADER_SIZE = 48;
+declare const PROPERTY_SET_HEADER_SIZE = 8;
+declare const IDENTIFIER_AND_OFFSET_SIZE = 8;
+declare const TYPED_VALUE_HEADER_SIZE = 4;
+declare const VT_I2 = 2;
+declare const VT_I4 = 3;
+declare const VT_LPSTR = 30;
+declare const VT_LPWSTR = 31;
+declare const VT_FILETIME = 64;
+declare const PID_DICTIONARY = 0;
+declare const PID_CODEPAGE = 1;
+declare const CP_WINUNICODE = 1200;
+declare const WINDOWS_1252_CODEPAGE = 1252;
+declare const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+declare function readGuid(view: DataView, offset: number): string;
+declare function writeGuid(view: DataView, offset: number, guid: string): void;
+declare function filetimeToDate(low: number, high: number): Date;
+declare function dateToFiletime(date: Date): {
+  readonly low: number;
+  readonly high: number;
+};
+type PropertyValue = {
+  readonly type: "VT_I2";
+  readonly value: number;
+} | {
+  readonly type: "VT_I4";
+  readonly value: number;
+} | {
+  readonly type: "VT_LPSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_LPWSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_FILETIME";
+  readonly value: Date;
+};
+interface PropertySet {
+  readonly formatId: string;
+  readonly properties: ReadonlyMap<number, PropertyValue>;
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, PropertySet, PropertyValue, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/wire.d.ts

@@ -0,0 +1,45 @@
+//#region src/oleps/wire.d.ts
+declare const BYTE_ORDER_MARK = 65534;
+declare const HEADER_SIZE = 48;
+declare const PROPERTY_SET_HEADER_SIZE = 8;
+declare const IDENTIFIER_AND_OFFSET_SIZE = 8;
+declare const TYPED_VALUE_HEADER_SIZE = 4;
+declare const VT_I2 = 2;
+declare const VT_I4 = 3;
+declare const VT_LPSTR = 30;
+declare const VT_LPWSTR = 31;
+declare const VT_FILETIME = 64;
+declare const PID_DICTIONARY = 0;
+declare const PID_CODEPAGE = 1;
+declare const CP_WINUNICODE = 1200;
+declare const WINDOWS_1252_CODEPAGE = 1252;
+declare const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+declare function readGuid(view: DataView, offset: number): string;
+declare function writeGuid(view: DataView, offset: number, guid: string): void;
+declare function filetimeToDate(low: number, high: number): Date;
+declare function dateToFiletime(date: Date): {
+  readonly low: number;
+  readonly high: number;
+};
+type PropertyValue = {
+  readonly type: "VT_I2";
+  readonly value: number;
+} | {
+  readonly type: "VT_I4";
+  readonly value: number;
+} | {
+  readonly type: "VT_LPSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_LPWSTR";
+  readonly value: string;
+} | {
+  readonly type: "VT_FILETIME";
+  readonly value: Date;
+};
+interface PropertySet {
+  readonly formatId: string;
+  readonly properties: ReadonlyMap<number, PropertyValue>;
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, PropertySet, PropertyValue, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/wire.js

@@ -0,0 +1,51 @@
+//#region src/oleps/wire.ts
+const BYTE_ORDER_MARK = 65534;
+const HEADER_SIZE = 48;
+const PROPERTY_SET_HEADER_SIZE = 8;
+const IDENTIFIER_AND_OFFSET_SIZE = 8;
+const TYPED_VALUE_HEADER_SIZE = 4;
+const VT_I2 = 2;
+const VT_I4 = 3;
+const VT_LPSTR = 30;
+const VT_LPWSTR = 31;
+const VT_FILETIME = 64;
+const PID_DICTIONARY = 0;
+const PID_CODEPAGE = 1;
+const CP_WINUNICODE = 1200;
+const WINDOWS_1252_CODEPAGE = 1252;
+const GUID_NULL = "{00000000-0000-0000-0000-000000000000}";
+function hex(n, width) {
+	return n.toString(16).padStart(width, "0");
+}
+function readGuid(view, offset) {
+	const data1 = hex(view.getUint32(offset, true), 8);
+	const data2 = hex(view.getUint16(offset + 4, true), 4);
+	const data3 = hex(view.getUint16(offset + 6, true), 4);
+	let data4a = "";
+	for (let i = 0; i < 2; i++) data4a += hex(view.getUint8(offset + 8 + i), 2);
+	let data4b = "";
+	for (let i = 2; i < 8; i++) data4b += hex(view.getUint8(offset + 8 + i), 2);
+	return `{${data1}-${data2}-${data3}-${data4a}-${data4b}}`.toUpperCase();
+}
+function writeGuid(view, offset, guid) {
+	const digits = guid.replace(/[{}-]/g, "");
+	view.setUint32(offset, Number.parseInt(digits.slice(0, 8), 16), true);
+	view.setUint16(offset + 4, Number.parseInt(digits.slice(8, 12), 16), true);
+	view.setUint16(offset + 6, Number.parseInt(digits.slice(12, 16), 16), true);
+	for (let i = 0; i < 8; i++) view.setUint8(offset + 8 + i, Number.parseInt(digits.slice(16 + i * 2, 18 + i * 2), 16));
+}
+const FILETIME_EPOCH_OFFSET_100NS = 116444736000000000n;
+const HUNDRED_NS_PER_MS = 10000n;
+function filetimeToDate(low, high) {
+	const ms = ((BigInt(high) << 32n | BigInt(low)) - FILETIME_EPOCH_OFFSET_100NS) / HUNDRED_NS_PER_MS;
+	return new Date(Number(ms));
+}
+function dateToFiletime(date) {
+	const ticks = BigInt(date.getTime()) * HUNDRED_NS_PER_MS + FILETIME_EPOCH_OFFSET_100NS;
+	return {
+		low: Number(ticks & 4294967295n),
+		high: Number(ticks >> 32n & 4294967295n)
+	};
+}
+//#endregion
+export { BYTE_ORDER_MARK, CP_WINUNICODE, GUID_NULL, HEADER_SIZE, IDENTIFIER_AND_OFFSET_SIZE, PID_CODEPAGE, PID_DICTIONARY, PROPERTY_SET_HEADER_SIZE, TYPED_VALUE_HEADER_SIZE, VT_FILETIME, VT_I2, VT_I4, VT_LPSTR, VT_LPWSTR, WINDOWS_1252_CODEPAGE, dateToFiletime, filetimeToDate, readGuid, writeGuid };

package/dist/oleps/write.cjs

@@ -0,0 +1,103 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_oleps_wire = require("./wire.cjs");
+//#region src/oleps/write.ts
+var PropertySetWriteError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "PropertySetWriteError";
+	}
+};
+function encodeUnicodeStringValue(value) {
+	const characterBytes = new Uint8Array((value.length + 1) * 2);
+	const charView = new DataView(characterBytes.buffer);
+	for (let i = 0; i < value.length; i++) charView.setUint16(i * 2, value.charCodeAt(i), true);
+	charView.setUint16(value.length * 2, 0, true);
+	return characterBytes;
+}
+function padTo4(length) {
+	return Math.ceil(length / 4) * 4;
+}
+function encodeTypedPropertyValue(value) {
+	switch (value.type) {
+		case "VT_I2": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 2, true);
+			view.setUint16(2, 0, true);
+			view.setInt16(4, value.value, true);
+			view.setUint16(6, 0, true);
+			return bytes;
+		}
+		case "VT_I4": {
+			const bytes = /* @__PURE__ */ new Uint8Array(8);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 3, true);
+			view.setUint16(2, 0, true);
+			view.setInt32(4, value.value, true);
+			return bytes;
+		}
+		case "VT_FILETIME": {
+			const { low, high } = require_oleps_wire.dateToFiletime(value.value);
+			const bytes = /* @__PURE__ */ new Uint8Array(12);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 64, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, low, true);
+			view.setUint32(8, high, true);
+			return bytes;
+		}
+		case "VT_LPWSTR": {
+			const characters = encodeUnicodeStringValue(value.value);
+			const paddedLength = padTo4(characters.length);
+			const bytes = new Uint8Array(8 + paddedLength);
+			const view = new DataView(bytes.buffer);
+			view.setUint16(0, 31, true);
+			view.setUint16(2, 0, true);
+			view.setUint32(4, characters.length / 2, true);
+			bytes.set(characters, 8);
+			return bytes;
+		}
+		case "VT_LPSTR": throw new PropertySetWriteError("writePropertySetStream cannot write a VT_LPSTR property: this writer emits Unicode (VT_LPWSTR) strings only, since encoding to an arbitrary ANSI codepage is out of scope -- see the package README's OLEPS scope note");
+	}
+}
+function writePropertySetStream(propertySet) {
+	const entries = [...propertySet.properties.entries()].sort(([a], [b]) => a - b);
+	const dictionaryBytes = new Uint8Array(entries.length * 8);
+	const dictionaryView = new DataView(dictionaryBytes.buffer);
+	const valueChunks = [];
+	let valueOffset = 8 + dictionaryBytes.length;
+	let index = 0;
+	for (const [pid, value] of entries) {
+		const encoded = encodeTypedPropertyValue(value);
+		dictionaryView.setUint32(index * 8, pid, true);
+		dictionaryView.setUint32(index * 8 + 4, valueOffset, true);
+		valueChunks.push(encoded);
+		valueOffset += encoded.length;
+		index += 1;
+	}
+	const propertySetSize = valueOffset;
+	const propertySetBytes = new Uint8Array(propertySetSize);
+	const propertySetView = new DataView(propertySetBytes.buffer);
+	propertySetView.setUint32(0, propertySetSize, true);
+	propertySetView.setUint32(4, entries.length, true);
+	propertySetBytes.set(dictionaryBytes, 8);
+	let cursor = 8 + dictionaryBytes.length;
+	for (const chunk of valueChunks) {
+		propertySetBytes.set(chunk, cursor);
+		cursor += chunk.length;
+	}
+	const streamBytes = new Uint8Array(48 + propertySetBytes.length);
+	const view = new DataView(streamBytes.buffer);
+	view.setUint16(0, require_oleps_wire.BYTE_ORDER_MARK, true);
+	view.setUint16(2, 0, true);
+	view.setUint32(4, 0, true);
+	require_oleps_wire.writeGuid(view, 8, require_oleps_wire.GUID_NULL);
+	view.setUint32(24, 1, true);
+	require_oleps_wire.writeGuid(view, 28, propertySet.formatId);
+	view.setUint32(44, 48, true);
+	streamBytes.set(propertySetBytes, 48);
+	return streamBytes;
+}
+//#endregion
+exports.PropertySetWriteError = PropertySetWriteError;
+exports.writePropertySetStream = writePropertySetStream;

package/dist/oleps/write.d.cts

@@ -0,0 +1,8 @@
+import { PropertySet } from "./wire.cjs";
+//#region src/oleps/write.d.ts
+declare class PropertySetWriteError extends Error {
+  constructor(message: string);
+}
+declare function writePropertySetStream(propertySet: PropertySet): Uint8Array<ArrayBuffer>;
+//#endregion
+export { PropertySetWriteError, writePropertySetStream };