@arkiv-network/sdk 0.7.0 → 0.8.0-advanced.3

package/dist/logger-CVpvU8ik.js

@@ -0,0 +1,153 @@
+//#region src/errors.ts
+var EntityMutationError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "EntityMutationError";
+	}
+};
+var NoMoreResultsError = class extends Error {
+	constructor() {
+		super("No more results — the last page carried no cursor. Check hasNextPage() before next().");
+		this.name = "NoMoreResultsError";
+	}
+};
+var NoEntityFoundError = class extends Error {
+	/** The key that matched nothing, when the lookup was by key. */
+	entityKey;
+	constructor(entityKey) {
+		super(entityKey === void 0 ? "No entity found" : `No live entity with key ${entityKey}. It was never created, or it has been deleted or has expired.`);
+		this.name = "NoEntityFoundError";
+		this.entityKey = entityKey;
+	}
+};
+var EmptyPatchError = class extends Error {
+	entityKey;
+	constructor(entityKey) {
+		super(`The patch for entity ${entityKey} has nothing to apply. Pass "set" to write attributes, "unset" to remove them, or "payload"/"contentType" to replace the contents.`);
+		this.name = "EmptyPatchError";
+		this.entityKey = entityKey;
+	}
+};
+var InvalidContentTypeError = class extends Error {
+	constructor(contentType) {
+		super(`Invalid content type "${contentType}". Must follow RFC 2045 MIME grammar and be lowercase only (e.g. "text/plain").`);
+		this.name = "InvalidContentTypeError";
+	}
+};
+
+//#endregion
+//#region src/utils/logger.ts
+const ROOT_NAMESPACE = "arkiv";
+function getDebugEnv() {
+	if (typeof process !== "undefined") {
+		const debugEnv = process?.env?.DEBUG;
+		if (debugEnv) return debugEnv;
+	}
+	if (typeof globalThis !== "undefined" && "localStorage" in globalThis) try {
+		return globalThis.localStorage?.getItem("DEBUG") || "";
+	} catch {}
+	return "";
+}
+function matchesPattern(namespace, pattern) {
+	if (pattern === namespace) return true;
+	if (pattern.endsWith("*")) {
+		const prefix = pattern.slice(0, -1);
+		return namespace.startsWith(prefix);
+	}
+	if (pattern.startsWith("-")) return !matchesPattern(namespace, pattern.slice(1));
+	return false;
+}
+function isEnabled(namespace) {
+	const debugEnv = getDebugEnv();
+	if (!debugEnv) return false;
+	const patterns = debugEnv.split(/[\s,]+/).filter((p) => p.length > 0);
+	if (patterns.length === 0) return false;
+	let enabled = false;
+	for (const pattern of patterns) if (pattern.startsWith("-")) {
+		if (matchesPattern(namespace, pattern)) return false;
+	} else if (matchesPattern(namespace, pattern)) enabled = true;
+	return enabled;
+}
+const enabledNamespaces = /* @__PURE__ */ new Set();
+const disabledNamespaces = /* @__PURE__ */ new Set();
+const COLOR_PALETTE = [
+	"#0000FF",
+	"#008000",
+	"#FF0000",
+	"#FF00FF",
+	"#FFA500",
+	"#800080",
+	"#00CED1",
+	"#FF1493",
+	"#32CD32",
+	"#1E90FF",
+	"#FF4500",
+	"#9370DB",
+	"#00FA9A",
+	"#FFD700",
+	"#DC143C",
+	"#00BFFF",
+	"#FF69B4",
+	"#20B2AA",
+	"#DA70D6",
+	"#4682B4"
+];
+const isNode = typeof process !== "undefined" && process.versions?.node != null;
+const ANSI_COLORS = [
+	"\x1B[94m",
+	"\x1B[92m",
+	"\x1B[91m",
+	"\x1B[95m",
+	"\x1B[93m",
+	"\x1B[96m",
+	"\x1B[35m",
+	"\x1B[36m",
+	"\x1B[32m",
+	"\x1B[34m",
+	"\x1B[33m",
+	"\x1B[31m",
+	"\x1B[90m",
+	"\x1B[37m",
+	"\x1B[1m"
+];
+const ANSI_RESET = "\x1B[0m";
+const ANSI_BOLD = "\x1B[1m";
+const namespaceColors = /* @__PURE__ */ new Map();
+function getColorForNamespace(namespace) {
+	const cachedColor = namespaceColors.get(namespace);
+	if (cachedColor) return cachedColor;
+	let hash = 0;
+	for (let i = 0; i < namespace.length; i++) {
+		const char = namespace.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash = hash & hash;
+	}
+	const colorIndex = Math.abs(hash) % COLOR_PALETTE.length;
+	const color = {
+		css: COLOR_PALETTE[colorIndex] ?? "inherit",
+		ansi: ANSI_COLORS[colorIndex % ANSI_COLORS.length] ?? ""
+	};
+	namespaceColors.set(namespace, color);
+	return color;
+}
+function createDebugLogger(namespace) {
+	const colors = getColorForNamespace(namespace);
+	return (...args) => {
+		const envEnabled = isEnabled(namespace);
+		const progEnabled = enabledNamespaces.has(namespace) && !disabledNamespaces.has(namespace);
+		if (envEnabled || progEnabled) if (isNode) {
+			const coloredNamespace = `${ANSI_BOLD}${colors.ansi}${namespace}${ANSI_RESET}`;
+			console.log(coloredNamespace, ...args);
+		} else {
+			const style1 = `color: ${colors.css}; font-weight: bold`;
+			console.log(`%c${namespace}%c`, style1, "color: inherit; font-weight: normal", ...args);
+		}
+	};
+}
+const getLogger = (scope) => {
+	return createDebugLogger(`${ROOT_NAMESPACE}:${scope}`);
+};
+
+//#endregion
+export { NoEntityFoundError as a, InvalidContentTypeError as i, EmptyPatchError as n, NoMoreResultsError as o, EntityMutationError as r, getLogger as t };
+//# sourceMappingURL=logger-CVpvU8ik.js.map

package/dist/logger-CVpvU8ik.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CVpvU8ik.js","names":["enabledNamespaces: Set<string>","disabledNamespaces: Set<string>"],"sources":["../src/errors.ts","../src/utils/logger.ts"],"sourcesContent":["export class EntityMutationError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options)\n    this.name = \"EntityMutationError\"\n  }\n}\nexport class NoMoreResultsError extends Error {\n  constructor() {\n    super(\"No more results — the last page carried no cursor. Check hasNextPage() before next().\")\n    this.name = \"NoMoreResultsError\"\n  }\n}\n\nexport class NoEntityFoundError extends Error {\n  /** The key that matched nothing, when the lookup was by key. */\n  readonly entityKey: string | undefined\n\n  constructor(entityKey?: string) {\n    super(\n      entityKey === undefined\n        ? \"No entity found\"\n        : `No live entity with key ${entityKey}. It was never created, or it has been deleted or ` +\n            \"has expired.\",\n    )\n    this.name = \"NoEntityFoundError\"\n    this.entityKey = entityKey\n  }\n}\n\nexport class EmptyPatchError extends Error {\n  readonly entityKey: string\n\n  constructor(entityKey: string) {\n    super(\n      `The patch for entity ${entityKey} has nothing to apply. Pass \"set\" to write attributes, ` +\n        '\"unset\" to remove them, or \"payload\"/\"contentType\" to replace the contents.',\n    )\n    this.name = \"EmptyPatchError\"\n    this.entityKey = entityKey\n  }\n}\n\nexport class InvalidContentTypeError extends Error {\n  constructor(contentType: string) {\n    super(\n      `Invalid content type \"${contentType}\". Must follow RFC 2045 MIME grammar and be lowercase only (e.g. \"text/plain\").`,\n    )\n    this.name = \"InvalidContentTypeError\"\n  }\n}\n","const ROOT_NAMESPACE = \"arkiv\"\n\n// Debug logger type - returns a function that can be called to log messages\ntype DebugLogger = (...args: unknown[]) => void\n\n// Get DEBUG environment variable (works in both Node.js and browser)\nfunction getDebugEnv(): string {\n  if (typeof process !== \"undefined\") {\n    const debugEnv = process?.env?.DEBUG\n    if (debugEnv) {\n      return debugEnv\n    }\n  }\n  // Browser: check localStorage\n  if (typeof globalThis !== \"undefined\" && \"localStorage\" in globalThis) {\n    try {\n      const storage = (globalThis as { localStorage?: Storage }).localStorage\n      return storage?.getItem(\"DEBUG\") || \"\"\n    } catch {\n      // localStorage might not be available\n    }\n  }\n  return \"\"\n}\n\n// Parse debug patterns and check if a namespace matches\nfunction matchesPattern(namespace: string, pattern: string): boolean {\n  // Exact match\n  if (pattern === namespace) return true\n\n  // Wildcard match: \"arkiv:*\" matches \"arkiv:query\", \"arkiv:rpc\", etc.\n  if (pattern.endsWith(\"*\")) {\n    const prefix = pattern.slice(0, -1)\n    return namespace.startsWith(prefix)\n  }\n\n  // Negative match: \"-arkiv:query\" excludes \"arkiv:query\"\n  if (pattern.startsWith(\"-\")) {\n    const excludePattern = pattern.slice(1)\n    return !matchesPattern(namespace, excludePattern)\n  }\n\n  return false\n}\n\n// Check if a namespace is enabled for debugging\nfunction isEnabled(namespace: string): boolean {\n  const debugEnv = getDebugEnv()\n  if (!debugEnv) return false\n\n  // Split by comma/space and check each pattern\n  const patterns = debugEnv.split(/[\\s,]+/).filter((p) => p.length > 0)\n\n  // If no patterns, nothing is enabled\n  if (patterns.length === 0) return false\n\n  // Check if any pattern matches (or if explicitly excluded)\n  let enabled = false\n  for (const pattern of patterns) {\n    if (pattern.startsWith(\"-\")) {\n      // Exclude pattern - if it matches, disable\n      if (matchesPattern(namespace, pattern)) {\n        return false\n      }\n    } else if (matchesPattern(namespace, pattern)) {\n      enabled = true\n    }\n  }\n\n  return enabled\n}\n\n// Store enabled namespaces (for programmatic enable/disable)\nconst enabledNamespaces: Set<string> = new Set()\nconst disabledNamespaces: Set<string> = new Set()\n\n// Color palette for namespace coloring (distinct, readable colors)\nconst COLOR_PALETTE = [\n  \"#0000FF\", // blue\n  \"#008000\", // green\n  \"#FF0000\", // red\n  \"#FF00FF\", // magenta\n  \"#FFA500\", // orange\n  \"#800080\", // purple\n  \"#00CED1\", // dark turquoise\n  \"#FF1493\", // deep pink\n  \"#32CD32\", // lime green\n  \"#1E90FF\", // dodger blue\n  \"#FF4500\", // orange red\n  \"#9370DB\", // medium purple\n  \"#00FA9A\", // medium spring green\n  \"#FFD700\", // gold\n  \"#DC143C\", // crimson\n  \"#00BFFF\", // deep sky blue\n  \"#FF69B4\", // hot pink\n  \"#20B2AA\", // light sea green\n  \"#DA70D6\", // orchid\n  \"#4682B4\", // steel blue\n]\n\n// Detect if we're in Node.js (for ANSI colors) or browser (for CSS colors)\nconst isNode = typeof process !== \"undefined\" && process.versions?.node != null\n\n// ANSI color codes for Node.js (bright, distinct colors)\nconst ANSI_COLORS = [\n  \"\\x1b[94m\", // bright blue\n  \"\\x1b[92m\", // bright green\n  \"\\x1b[91m\", // bright red\n  \"\\x1b[95m\", // bright magenta\n  \"\\x1b[93m\", // bright yellow\n  \"\\x1b[96m\", // bright cyan\n  \"\\x1b[35m\", // magenta\n  \"\\x1b[36m\", // cyan\n  \"\\x1b[32m\", // green\n  \"\\x1b[34m\", // blue\n  \"\\x1b[33m\", // yellow\n  \"\\x1b[31m\", // red\n  \"\\x1b[90m\", // bright black (gray)\n  \"\\x1b[37m\", // white\n  \"\\x1b[1m\", // bold (as a color option)\n]\n\nconst ANSI_RESET = \"\\x1b[0m\"\nconst ANSI_BOLD = \"\\x1b[1m\"\n\n// Cache colors for namespaces (same namespace = same color)\nconst namespaceColors = new Map<string, { css: string; ansi: string }>()\n\n// Generate a consistent color for a namespace based on its hash\nfunction getColorForNamespace(namespace: string): { css: string; ansi: string } {\n  // Check cache first\n  const cachedColor = namespaceColors.get(namespace)\n  if (cachedColor) {\n    return cachedColor\n  }\n\n  // Simple hash function to convert string to number\n  let hash = 0\n  for (let i = 0; i < namespace.length; i++) {\n    const char = namespace.charCodeAt(i)\n    hash = (hash << 5) - hash + char\n    hash = hash & hash // Convert to 32-bit integer\n  }\n\n  // Use absolute value and modulo to get index\n  const colorIndex = Math.abs(hash) % COLOR_PALETTE.length\n  const cssColor = COLOR_PALETTE[colorIndex] ?? \"inherit\"\n  const ansiColor = ANSI_COLORS[colorIndex % ANSI_COLORS.length] ?? \"\"\n\n  const color = { css: cssColor, ansi: ansiColor }\n\n  // Cache the color\n  namespaceColors.set(namespace, color)\n\n  return color\n}\n\n// Create a debug logger function\nfunction createDebugLogger(namespace: string): DebugLogger {\n  // Get the color for this namespace (consistent across calls)\n  const colors = getColorForNamespace(namespace)\n\n  return (...args: unknown[]) => {\n    // Check if enabled via environment variable or programmatically\n    const envEnabled = isEnabled(namespace)\n    const progEnabled = enabledNamespaces.has(namespace) && !disabledNamespaces.has(namespace)\n\n    if (envEnabled || progEnabled) {\n      if (isNode) {\n        // Node.js: use ANSI color codes\n        const coloredNamespace = `${ANSI_BOLD}${colors.ansi}${namespace}${ANSI_RESET}`\n        console.log(coloredNamespace, ...args)\n      } else {\n        // Browser: use CSS styling with %c\n        // The format is: console.log(\"%cstyled%cnormal\", style1, style2, ...args)\n        // This colors the namespace, then resets for the rest\n        const style1 = `color: ${colors.css}; font-weight: bold`\n        const style2 = \"color: inherit; font-weight: normal\"\n        // Combine namespace with a space, then log with styles\n        console.log(`%c${namespace}%c`, style1, style2, ...args)\n      }\n    }\n  }\n}\n\nexport const getLogger = (scope: string): DebugLogger => {\n  const namespace = `${ROOT_NAMESPACE}:${scope}`\n  return createDebugLogger(namespace)\n}\n\nexport const enableDebug = (namespaces: string): void => {\n  // Parse and add namespaces to enabled set\n  const patterns = namespaces.split(/[\\s,]+/).filter((p) => p.length > 0)\n  for (const pattern of patterns) {\n    if (pattern.startsWith(\"-\")) {\n      // Remove from enabled, add to disabled\n      const namespace = pattern.slice(1)\n      enabledNamespaces.delete(namespace)\n      disabledNamespaces.add(namespace)\n    } else {\n      enabledNamespaces.add(pattern)\n      disabledNamespaces.delete(pattern)\n    }\n  }\n}\n\nexport const disableDebug = (): void => {\n  enabledNamespaces.clear()\n  disabledNamespaces.clear()\n}\n"],"mappings":"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"}

package/dist/logger-Cr15lPAQ.cjs

@@ -0,0 +1,188 @@
+
+//#region src/errors.ts
+var EntityMutationError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "EntityMutationError";
+	}
+};
+var NoMoreResultsError = class extends Error {
+	constructor() {
+		super("No more results — the last page carried no cursor. Check hasNextPage() before next().");
+		this.name = "NoMoreResultsError";
+	}
+};
+var NoEntityFoundError = class extends Error {
+	/** The key that matched nothing, when the lookup was by key. */
+	entityKey;
+	constructor(entityKey) {
+		super(entityKey === void 0 ? "No entity found" : `No live entity with key ${entityKey}. It was never created, or it has been deleted or has expired.`);
+		this.name = "NoEntityFoundError";
+		this.entityKey = entityKey;
+	}
+};
+var EmptyPatchError = class extends Error {
+	entityKey;
+	constructor(entityKey) {
+		super(`The patch for entity ${entityKey} has nothing to apply. Pass "set" to write attributes, "unset" to remove them, or "payload"/"contentType" to replace the contents.`);
+		this.name = "EmptyPatchError";
+		this.entityKey = entityKey;
+	}
+};
+var InvalidContentTypeError = class extends Error {
+	constructor(contentType) {
+		super(`Invalid content type "${contentType}". Must follow RFC 2045 MIME grammar and be lowercase only (e.g. "text/plain").`);
+		this.name = "InvalidContentTypeError";
+	}
+};
+
+//#endregion
+//#region src/utils/logger.ts
+const ROOT_NAMESPACE = "arkiv";
+function getDebugEnv() {
+	if (typeof process !== "undefined") {
+		const debugEnv = process?.env?.DEBUG;
+		if (debugEnv) return debugEnv;
+	}
+	if (typeof globalThis !== "undefined" && "localStorage" in globalThis) try {
+		return globalThis.localStorage?.getItem("DEBUG") || "";
+	} catch {}
+	return "";
+}
+function matchesPattern(namespace, pattern) {
+	if (pattern === namespace) return true;
+	if (pattern.endsWith("*")) {
+		const prefix = pattern.slice(0, -1);
+		return namespace.startsWith(prefix);
+	}
+	if (pattern.startsWith("-")) return !matchesPattern(namespace, pattern.slice(1));
+	return false;
+}
+function isEnabled(namespace) {
+	const debugEnv = getDebugEnv();
+	if (!debugEnv) return false;
+	const patterns = debugEnv.split(/[\s,]+/).filter((p) => p.length > 0);
+	if (patterns.length === 0) return false;
+	let enabled = false;
+	for (const pattern of patterns) if (pattern.startsWith("-")) {
+		if (matchesPattern(namespace, pattern)) return false;
+	} else if (matchesPattern(namespace, pattern)) enabled = true;
+	return enabled;
+}
+const enabledNamespaces = /* @__PURE__ */ new Set();
+const disabledNamespaces = /* @__PURE__ */ new Set();
+const COLOR_PALETTE = [
+	"#0000FF",
+	"#008000",
+	"#FF0000",
+	"#FF00FF",
+	"#FFA500",
+	"#800080",
+	"#00CED1",
+	"#FF1493",
+	"#32CD32",
+	"#1E90FF",
+	"#FF4500",
+	"#9370DB",
+	"#00FA9A",
+	"#FFD700",
+	"#DC143C",
+	"#00BFFF",
+	"#FF69B4",
+	"#20B2AA",
+	"#DA70D6",
+	"#4682B4"
+];
+const isNode = typeof process !== "undefined" && process.versions?.node != null;
+const ANSI_COLORS = [
+	"\x1B[94m",
+	"\x1B[92m",
+	"\x1B[91m",
+	"\x1B[95m",
+	"\x1B[93m",
+	"\x1B[96m",
+	"\x1B[35m",
+	"\x1B[36m",
+	"\x1B[32m",
+	"\x1B[34m",
+	"\x1B[33m",
+	"\x1B[31m",
+	"\x1B[90m",
+	"\x1B[37m",
+	"\x1B[1m"
+];
+const ANSI_RESET = "\x1B[0m";
+const ANSI_BOLD = "\x1B[1m";
+const namespaceColors = /* @__PURE__ */ new Map();
+function getColorForNamespace(namespace) {
+	const cachedColor = namespaceColors.get(namespace);
+	if (cachedColor) return cachedColor;
+	let hash = 0;
+	for (let i = 0; i < namespace.length; i++) {
+		const char = namespace.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash = hash & hash;
+	}
+	const colorIndex = Math.abs(hash) % COLOR_PALETTE.length;
+	const color = {
+		css: COLOR_PALETTE[colorIndex] ?? "inherit",
+		ansi: ANSI_COLORS[colorIndex % ANSI_COLORS.length] ?? ""
+	};
+	namespaceColors.set(namespace, color);
+	return color;
+}
+function createDebugLogger(namespace) {
+	const colors = getColorForNamespace(namespace);
+	return (...args) => {
+		const envEnabled = isEnabled(namespace);
+		const progEnabled = enabledNamespaces.has(namespace) && !disabledNamespaces.has(namespace);
+		if (envEnabled || progEnabled) if (isNode) {
+			const coloredNamespace = `${ANSI_BOLD}${colors.ansi}${namespace}${ANSI_RESET}`;
+			console.log(coloredNamespace, ...args);
+		} else {
+			const style1 = `color: ${colors.css}; font-weight: bold`;
+			console.log(`%c${namespace}%c`, style1, "color: inherit; font-weight: normal", ...args);
+		}
+	};
+}
+const getLogger = (scope) => {
+	return createDebugLogger(`${ROOT_NAMESPACE}:${scope}`);
+};
+
+//#endregion
+Object.defineProperty(exports, 'EmptyPatchError', {
+  enumerable: true,
+  get: function () {
+    return EmptyPatchError;
+  }
+});
+Object.defineProperty(exports, 'EntityMutationError', {
+  enumerable: true,
+  get: function () {
+    return EntityMutationError;
+  }
+});
+Object.defineProperty(exports, 'InvalidContentTypeError', {
+  enumerable: true,
+  get: function () {
+    return InvalidContentTypeError;
+  }
+});
+Object.defineProperty(exports, 'NoEntityFoundError', {
+  enumerable: true,
+  get: function () {
+    return NoEntityFoundError;
+  }
+});
+Object.defineProperty(exports, 'NoMoreResultsError', {
+  enumerable: true,
+  get: function () {
+    return NoMoreResultsError;
+  }
+});
+Object.defineProperty(exports, 'getLogger', {
+  enumerable: true,
+  get: function () {
+    return getLogger;
+  }
+});

package/dist/payload-Cvrir3Q-.cjs

@@ -0,0 +1,108 @@
+const require_expiry = require('./expiry-xr6mx4f7.cjs');
+const require_errors = require('./errors-51znTSB1.cjs');
+let viem = require("viem");
+
+//#region src/utils/expirationTime.ts
+function lifetimeOf(seconds) {
+	return require_expiry.makeExpiry(require_expiry.toBlocks(seconds), 0n);
+}
+function deadlineOf(expiresAt, options) {
+	return require_expiry.makeExpiry(options?.atLeast?.minLifetime ?? 0n, expiresAt);
+}
+/**
+* Builds the `expires` of a create or an extension.
+*
+* Every helper returns the `{ minLifetime, expiresAt }` pair the ABI carries, so what you write is
+* what goes on the wire. The `from*` helpers fill `minLifetime` and leave `expiresAt` at `0n`;
+* {@link ExpirationTime.atBlock} and {@link ExpirationTime.atDate} do the reverse. The engine takes
+* whichever comes later, which is why a deadline can also carry a floor.
+*
+* Values are plain data — no methods, no prototype — so they log, clone and compare like any other
+* object.
+*
+* @example The 90% case: a duration, and nothing else to think about.
+* await client.createEntity({ payload, contentType, expires: ExpirationTime.fromDays(30) })
+*
+* @example An exact block, or a wall-clock date.
+* expires: ExpirationTime.atBlock(1_200_000n)
+* expires: ExpirationTime.atDate(new Date("2027-01-01"))
+*
+* @example A deadline that still guarantees a minimum life.
+* expires: ExpirationTime.atBlock(1_200_000n, { atLeast: ExpirationTime.fromDays(1) })
+*/
+const ExpirationTime = {
+	fromSeconds: (seconds) => lifetimeOf(seconds),
+	fromMinutes: (minutes) => lifetimeOf(minutes * 60),
+	fromHours: (hours) => lifetimeOf(hours * 60 * 60),
+	fromDays: (days) => lifetimeOf(days * 24 * 60 * 60),
+	fromWeeks: (weeks) => lifetimeOf(weeks * 7 * 24 * 60 * 60),
+	fromMonths: (months) => lifetimeOf(months * 30 * 24 * 60 * 60),
+	fromYears: (years) => lifetimeOf(years * 365 * 24 * 60 * 60),
+	fromBlocks: (blocks) => {
+		if (!Number.isInteger(blocks) || blocks <= 0) throw new require_errors.InvalidExpiryError(`a lifetime must be a positive whole number of blocks, got ${blocks}`);
+		return require_expiry.makeExpiry(BigInt(blocks), 0n);
+	},
+	atBlock: (block, options) => {
+		if (typeof block !== "bigint" || block < 0n) throw new require_errors.InvalidExpiryError(`a deadline must be a non-negative block height, got ${block}`);
+		return deadlineOf(block, options);
+	},
+	atDate: (date, options) => {
+		if (!(date instanceof Date) || Number.isNaN(date.getTime())) throw new require_errors.InvalidExpiryError(`a deadline must be a valid Date, got ${String(date)}`);
+		return deadlineOf(date, options);
+	},
+	permanent: () => deadlineOf(require_expiry.MAX_EXPIRES_AT)
+};
+
+//#endregion
+//#region src/utils/payload.ts
+/**
+* A JSON-serialisable value as an entity payload — `JSON.stringify` then UTF-8.
+*
+* Pair it with `contentType: "application/json"`, which is what lets `entity.toJson()` read it back.
+*
+* @example
+* await client.createEntity({
+*   payload: jsonToPayload({ hello: "world" }),
+*   contentType: "application/json",
+*   expires: ExpirationTime.fromDays(30),
+* })
+*/
+function jsonToPayload(json) {
+	return (0, viem.toBytes)(JSON.stringify(json));
+}
+/**
+* A string as an entity payload, encoded as UTF-8.
+*
+* Hex-looking text is encoded as text: `stringToPayload("0xab")` gives the four bytes of that
+* string, not the single byte `0xab`. Read it back with `entity.toText()`.
+*
+* @example
+* await client.createEntity({
+*   payload: stringToPayload("hello"),
+*   contentType: "text/plain",
+*   expires: ExpirationTime.fromDays(30),
+* })
+*/
+function stringToPayload(data) {
+	return (0, viem.stringToBytes)(data);
+}
+
+//#endregion
+Object.defineProperty(exports, 'ExpirationTime', {
+  enumerable: true,
+  get: function () {
+    return ExpirationTime;
+  }
+});
+Object.defineProperty(exports, 'jsonToPayload', {
+  enumerable: true,
+  get: function () {
+    return jsonToPayload;
+  }
+});
+Object.defineProperty(exports, 'stringToPayload', {
+  enumerable: true,
+  get: function () {
+    return stringToPayload;
+  }
+});

package/dist/payload-D53ms-Mg.d.ts

@@ -0,0 +1,153 @@
+import { i as Lifetime, n as Expiry } from "./expiry-nDbCgZX4.js";
+
+//#region src/utils/expirationTime.d.ts
+
+/**
+ * The optional floor a deadline can carry.
+ *
+ * `atLeast` takes a duration — one of the `from*` helpers — and never another deadline, so
+ * `atBlock(x, { atLeast: atBlock(y) })` does not compile. Two deadlines are not a thing the engine
+ * can resolve.
+ */
+type DeadlineOptions = {
+  /** Live at least this long from now, even if the deadline is sooner. */
+  atLeast?: Lifetime | undefined;
+};
+/**
+ * Builds the `expires` of a create or an extension.
+ *
+ * Every helper returns the `{ minLifetime, expiresAt }` pair the ABI carries, so what you write is
+ * what goes on the wire. The `from*` helpers fill `minLifetime` and leave `expiresAt` at `0n`;
+ * {@link ExpirationTime.atBlock} and {@link ExpirationTime.atDate} do the reverse. The engine takes
+ * whichever comes later, which is why a deadline can also carry a floor.
+ *
+ * Values are plain data — no methods, no prototype — so they log, clone and compare like any other
+ * object.
+ *
+ * @example The 90% case: a duration, and nothing else to think about.
+ * await client.createEntity({ payload, contentType, expires: ExpirationTime.fromDays(30) })
+ *
+ * @example An exact block, or a wall-clock date.
+ * expires: ExpirationTime.atBlock(1_200_000n)
+ * expires: ExpirationTime.atDate(new Date("2027-01-01"))
+ *
+ * @example A deadline that still guarantees a minimum life.
+ * expires: ExpirationTime.atBlock(1_200_000n, { atLeast: ExpirationTime.fromDays(1) })
+ */
+declare const ExpirationTime: {
+  /**
+   * A raw number of seconds. Must be a whole number of blocks' worth — see the other helpers, which
+   * all produce one by construction.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromSeconds: (seconds: number) => Lifetime;
+  /**
+   * A number of minutes.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromMinutes: (minutes: number) => Lifetime;
+  /**
+   * A number of hours.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromHours: (hours: number) => Lifetime;
+  /**
+   * A number of days. The everyday form — `fromDays(30)` is what most creates want.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromDays: (days: number) => Lifetime;
+  /**
+   * A number of weeks, each of 7 days.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromWeeks: (weeks: number) => Lifetime;
+  /**
+   * A number of months, each of exactly **30 days** — calendar months are not all the same length,
+   * and a lifetime is a duration rather than a date. Use {@link ExpirationTime.atDate} when the
+   * expiry has to land on a particular calendar day.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromMonths: (months: number) => Lifetime;
+  /**
+   * A number of years, each of exactly **365 days** — leap days are not counted, so `fromYears(4)`
+   * is a day short of four calendar years. Use {@link ExpirationTime.atDate} for a calendar
+   * deadline.
+   *
+   * @throws {InvalidExpiryError} If the duration is not a positive multiple of the block time.
+   */
+  fromYears: (years: number) => Lifetime;
+  /**
+   * A number of blocks, for callers who think in the chain's own unit. Always exact — there is no
+   * conversion to be approximate about.
+   *
+   * @throws {InvalidExpiryError} If the count is not a positive whole number.
+   */
+  fromBlocks: (blocks: number) => Lifetime;
+  /**
+   * An absolute block height.
+   *
+   * @param block - The block the entity expires at.
+   * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
+   * @throws {InvalidExpiryError} If the height is negative.
+   */
+  atBlock: (block: bigint, options?: DeadlineOptions) => Expiry;
+  /**
+   * A wall-clock instant, placed against the block the transaction is built on.
+   *
+   * A date cannot land on a block boundary in general, so it rounds **up** to the next block: the
+   * entity lives until at least the instant asked for. This is why a date is never rejected for
+   * "not being a whole number of blocks" the way a duration is — it becomes a block height, not a
+   * duration.
+   *
+   * @param date - When the entity should expire.
+   * @param options - Optionally, a floor: `{ atLeast: ExpirationTime.fromDays(1) }`.
+   * @throws {InvalidExpiryError} If the value is not a valid `Date`.
+   */
+  atDate: (date: Date, options?: DeadlineOptions) => Expiry;
+  /**
+   * An entity that should never expire.
+   *
+   * This is `atBlock(MAX_EXPIRES_AT)` — the largest expiry the `uint64` field holds — and the
+   * engine treats it as an ordinary deadline rather than a special case. There is no permanence
+   * flag; a block height no chain will reach is what permanence is.
+   */
+  permanent: () => Expiry;
+};
+//#endregion
+//#region src/utils/payload.d.ts
+/**
+ * A JSON-serialisable value as an entity payload — `JSON.stringify` then UTF-8.
+ *
+ * Pair it with `contentType: "application/json"`, which is what lets `entity.toJson()` read it back.
+ *
+ * @example
+ * await client.createEntity({
+ *   payload: jsonToPayload({ hello: "world" }),
+ *   contentType: "application/json",
+ *   expires: ExpirationTime.fromDays(30),
+ * })
+ */
+declare function jsonToPayload(json: object): Uint8Array;
+/**
+ * A string as an entity payload, encoded as UTF-8.
+ *
+ * Hex-looking text is encoded as text: `stringToPayload("0xab")` gives the four bytes of that
+ * string, not the single byte `0xab`. Read it back with `entity.toText()`.
+ *
+ * @example
+ * await client.createEntity({
+ *   payload: stringToPayload("hello"),
+ *   contentType: "text/plain",
+ *   expires: ExpirationTime.fromDays(30),
+ * })
+ */
+declare function stringToPayload(data: string): Uint8Array;
+//#endregion
+export { ExpirationTime as i, stringToPayload as n, DeadlineOptions as r, jsonToPayload as t };
+//# sourceMappingURL=payload-D53ms-Mg.d.ts.map

package/dist/payload-D53ms-Mg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-D53ms-Mg.d.ts","names":[],"sources":["../src/utils/expirationTime.ts","../src/utils/payload.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;AAkCA;;;;AA2B4B,KA7DhB,eAAA,GA6DgB;EAOE;EASE,OAAA,CAAA,EA3EpB,QA2EoB,GAAA,SAAA;CASF;;;;;;;;;;;;ACnF9B;AAiBA;;;;;;;;;cDca;;;;;;;oCAOqB;;;;;;oCAMA;;;;;;gCAOJ;;;;;;8BAOF;;;;;;gCAOE;;;;;;;;kCASE;;;;;;;;gCASF;;;;;;;kCAQE;;;;;;;;qCAgBK,oBAAkB;;;;;;;;;;;;;iBAmBtC,gBAAgB,oBAAkB;;;;;;;;mBAclC;;;;;;;AA/IjB;AAkCA;;;;;;;;AA4DgC,iBC3FhB,aAAA,CD2FgB,IAAA,EAAA,MAAA,CAAA,EC3Fa,UD2Fb;;;;;;;;;;;AC3FhC;AAiBA;;iBAAgB,eAAA,gBAA+B"}