@milaboratories/pl-tree 1.8.47 → 1.8.49

package/dist/snapshot.cjs

@@ -1,88 +1,67 @@
-'use strict';
-
-var accessors = require('./accessors.cjs');
-var tsHelpers = require('@milaboratories/ts-helpers');
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_accessors = require('./accessors.cjs');
+let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 
+//#region src/snapshot.ts
 /** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */
 function rsSchema(schema) {
-    return schema;
+	return schema;
 }
 function makeResourceSnapshot(res, schema, ctx) {
-    const node = res instanceof accessors.PlTreeEntry
-        ? tsHelpers.notEmpty(ctx).accessor(res).node()
-        : res instanceof accessors.PlTreeEntryAccessor
-            ? res.node()
-            : res;
-    const info = node.resourceInfo;
-    const result = { ...info };
-    if (schema.data !== undefined) {
-        if (schema.data === "raw")
-            result.data = node.getData();
-        else
-            result.data = schema.data.parse(node.getDataAsJson());
-    }
-    if (schema.fields !== undefined) {
-        const fields = {};
-        // even if field is not defined, corresponding object field
-        // with "undefined" value will still be added
-        for (const [fieldName, required] of Object.entries(schema.fields))
-            fields[fieldName] = node.traverse({
-                field: fieldName,
-                errorIfFieldNotSet: required,
-                stableIfNotFound: !required,
-            })?.id;
-        result.fields = fields;
-    }
-    if (schema.kv !== undefined) {
-        const kv = {};
-        for (const [fieldName, type] of Object.entries(schema.kv)) {
-            const value = node.getKeyValue(fieldName);
-            if (value === undefined) {
-                throw new Error(`Key not found ${fieldName}`);
-            }
-            else if (type === "raw") {
-                kv[fieldName] = value;
-            }
-            else {
-                kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString("utf-8")));
-            }
-        }
-        result.kv = kv;
-    }
-    return result;
+	const node = res instanceof require_accessors.PlTreeEntry ? (0, _milaboratories_ts_helpers.notEmpty)(ctx).accessor(res).node() : res instanceof require_accessors.PlTreeEntryAccessor ? res.node() : res;
+	const result = { ...node.resourceInfo };
+	if (schema.data !== void 0) if (schema.data === "raw") result.data = node.getData();
+	else result.data = schema.data.parse(node.getDataAsJson());
+	if (schema.fields !== void 0) {
+		const fields = {};
+		for (const [fieldName, required] of Object.entries(schema.fields)) fields[fieldName] = node.traverse({
+			field: fieldName,
+			errorIfFieldNotSet: required,
+			stableIfNotFound: !required
+		})?.id;
+		result.fields = fields;
+	}
+	if (schema.kv !== void 0) {
+		const kv = {};
+		for (const [fieldName, type] of Object.entries(schema.kv)) {
+			const value = node.getKeyValue(fieldName);
+			if (value === void 0) throw new Error(`Key not found ${fieldName}`);
+			else if (type === "raw") kv[fieldName] = value;
+			else kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString("utf-8")));
+		}
+		result.kv = kv;
+	}
+	return result;
 }
 /** @deprecated */
 function treeEntryToResourceWithData(res, fields, ctx) {
-    if (res instanceof accessors.PlTreeEntry) {
-        const node = ctx.accessor(res).node();
-        const info = node.resourceInfo;
-        const fValues = fields.map((name) => [
-            name,
-            node.getField(name)?.value?.id,
-        ]);
-        return {
-            ...info,
-            fields: new Map(fValues),
-            data: node.getData() ?? new Uint8Array(),
-        };
-    }
-    return res;
+	if (res instanceof require_accessors.PlTreeEntry) {
+		const node = ctx.accessor(res).node();
+		const info = node.resourceInfo;
+		const fValues = fields.map((name) => [name, node.getField(name)?.value?.id]);
+		return {
+			...info,
+			fields: new Map(fValues),
+			data: node.getData() ?? new Uint8Array()
+		};
+	}
+	return res;
 }
 /** @deprecated */
 function treeEntryToResourceWithMetadata(res, mdKeys, ctx) {
-    if (!(res instanceof accessors.PlTreeEntry))
-        return res;
-    const node = ctx.accessor(res).node();
-    const info = node.resourceInfo;
-    const mdEntries = mdKeys.map((k) => [k, node.getKeyValue(k)]);
-    return {
-        ...info,
-        metadata: Object.fromEntries(mdEntries),
-    };
+	if (!(res instanceof require_accessors.PlTreeEntry)) return res;
+	const node = ctx.accessor(res).node();
+	const info = node.resourceInfo;
+	const mdEntries = mdKeys.map((k) => [k, node.getKeyValue(k)]);
+	return {
+		...info,
+		metadata: Object.fromEntries(mdEntries)
+	};
 }
 
+//#endregion
 exports.makeResourceSnapshot = makeResourceSnapshot;
 exports.rsSchema = rsSchema;
 exports.treeEntryToResourceWithData = treeEntryToResourceWithData;
 exports.treeEntryToResourceWithMetadata = treeEntryToResourceWithMetadata;
-//# sourceMappingURL=snapshot.cjs.map
+//# sourceMappingURL=snapshot.cjs.map

package/dist/snapshot.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.cjs","sources":["../src/snapshot.ts"],"sourcesContent":["import type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport type { Optional, Writable } from \"utility-types\";\nimport type { ZodType, z } from \"zod\";\nimport type { PlTreeNodeAccessor } from \"./accessors\";\nimport { PlTreeEntry, PlTreeEntryAccessor } from \"./accessors\";\nimport type { ComputableCtx } from \"@milaboratories/computable\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/**\n * A DTO that can be generated from a tree node to make a snapshot of specific parts of it's state.\n * Such snapshots can then be used in core that requires this information without the need of\n * retrieving state from the tree.\n */\nexport type ResourceSnapshot<\n  Data = undefined,\n  Fields extends Record<string, ResourceId | undefined> | undefined = undefined,\n  KV extends Record<string, unknown> | undefined = undefined,\n> = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** The most generic type of ResourceSnapshot. */\ntype ResourceSnapshotGeneric = ResourceSnapshot<\n  unknown,\n  Record<string, ResourceId | undefined> | undefined,\n  Record<string, unknown> | undefined\n>;\n\n/** Request that we'll pass to getResourceSnapshot function. We infer the type of ResourceSnapshot from this. */\nexport type ResourceSnapshotSchema<\n  Data extends ZodType | \"raw\" | undefined = undefined,\n  Fields extends Record<string, boolean> | undefined = undefined,\n  KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n> = {\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */\nexport function rsSchema<\n  const Data extends ZodType | \"raw\" | undefined = undefined,\n  const Fields extends Record<string, boolean> | undefined = undefined,\n  const KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n>(\n  schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>,\n): ResourceSnapshotSchema<Data, Fields, KV> {\n  return schema as any;\n}\n\n/** The most generic type of ResourceSnapshotSchema. */\ntype ResourceSnapshotSchemaGeneric = ResourceSnapshotSchema<\n  ZodType | \"raw\" | undefined,\n  Record<string, boolean> | undefined,\n  Record<string, ZodType | \"raw\"> | undefined\n>;\n\n/**\n * If Data is 'raw' in schema, we'll get bytes,\n * if it's Zod, we'll parse it via zod.\n * Or else we just got undefined in the field.\n */\ntype InferDataType<Data extends ZodType | \"raw\" | undefined> = Data extends \"raw\"\n  ? Uint8Array\n  : Data extends ZodType\n    ? z.infer<Data>\n    : undefined;\n\n/**\n * If Fields is a record of field names to booleans,\n * then if the value of the field is true, we'll require this field and throw a Error if it wasn't found.\n * If it's false and doesn't exist, we'll return undefined.\n * If Fields type is undefined, we won't set fields at all.\n */\ntype InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof Fields]: Fields[FieldName] extends true\n        ? ResourceId\n        : ResourceId | undefined;\n    };\n\n/**\n * If KV is undefined, won't set it.\n * If one of values is Zod, we'll get KV and converts it to Zod schema.\n * If the value is 'raw', just returns bytes.\n */\ntype InferKVType<KV extends Record<string, ZodType | \"raw\"> | undefined> = KV extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array;\n    };\n\n/** Infer ResourceSnapshot from ResourceShapshotSchema, S can be any ResourceSnapshotSchema. */\nexport type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<\n  InferDataType<S[\"data\"]>,\n  InferFieldsType<S[\"fields\"]>,\n  InferKVType<S[\"kv\"]>\n>;\n\n/** Gets a ResourceSnapshot from PlTreeEntry. */\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry,\n  schema: Schema,\n  ctx: ComputableCtx,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry | PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n  ctx?: ComputableCtx,\n): InferSnapshot<Schema> {\n  const node =\n    res instanceof PlTreeEntry\n      ? notEmpty(ctx).accessor(res).node()\n      : res instanceof PlTreeEntryAccessor\n        ? res.node()\n        : res;\n  const info = node.resourceInfo;\n  const result: Optional<Writable<ResourceSnapshotGeneric>, \"data\" | \"fields\" | \"kv\"> = { ...info };\n\n  if (schema.data !== undefined) {\n    if (schema.data === \"raw\") result.data = node.getData();\n    else result.data = schema.data.parse(node.getDataAsJson());\n  }\n\n  if (schema.fields !== undefined) {\n    const fields: Record<string, ResourceId | undefined> = {};\n    // even if field is not defined, corresponding object field\n    // with \"undefined\" value will still be added\n    for (const [fieldName, required] of Object.entries(schema.fields))\n      fields[fieldName] = node.traverse({\n        field: fieldName,\n        errorIfFieldNotSet: required,\n        stableIfNotFound: !required,\n      })?.id;\n    result.fields = fields;\n  }\n\n  if (schema.kv !== undefined) {\n    const kv: Record<string, unknown> = {};\n    for (const [fieldName, type] of Object.entries(schema.kv)) {\n      const value = node.getKeyValue(fieldName);\n\n      if (value === undefined) {\n        throw new Error(`Key not found ${fieldName}`);\n      } else if (type === \"raw\") {\n        kv[fieldName] = value;\n      } else {\n        kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString(\"utf-8\")));\n      }\n    }\n    result.kv = kv;\n  }\n\n  return result as any;\n}\n\n/** @deprecated */\nexport type ResourceWithData = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly fields: Map<string, ResourceId | undefined>;\n  readonly data?: Uint8Array;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithData(\n  res: PlTreeEntry | ResourceWithData,\n  fields: string[],\n  ctx: ComputableCtx,\n): ResourceWithData {\n  if (res instanceof PlTreeEntry) {\n    const node = ctx.accessor(res).node();\n    const info = node.resourceInfo;\n\n    const fValues: [string, ResourceId | undefined][] = fields.map((name) => [\n      name,\n      node.getField(name)?.value?.id,\n    ]);\n\n    return {\n      ...info,\n      fields: new Map(fValues),\n      data: node.getData() ?? new Uint8Array(),\n    };\n  }\n\n  return res;\n}\n\n/** @deprecated */\nexport type ResourceWithMetadata = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly metadata: Record<string, any>;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithMetadata(\n  res: PlTreeEntry | ResourceWithMetadata,\n  mdKeys: string[],\n  ctx: ComputableCtx,\n): ResourceWithMetadata {\n  if (!(res instanceof PlTreeEntry)) return res;\n\n  const node = ctx.accessor(res).node();\n  const info = node.resourceInfo;\n  const mdEntries: [string, any][] = mdKeys.map((k) => [k, node.getKeyValue(k)]);\n\n  return {\n    ...info,\n    metadata: Object.fromEntries(mdEntries),\n  };\n}\n"],"names":["PlTreeEntry","notEmpty","PlTreeEntryAccessor"],"mappings":"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"}
+{"version":3,"file":"snapshot.cjs","names":["PlTreeEntry","PlTreeEntryAccessor"],"sources":["../src/snapshot.ts"],"sourcesContent":["import type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport type { Optional, Writable } from \"utility-types\";\nimport type { ZodType, z } from \"zod\";\nimport type { PlTreeNodeAccessor } from \"./accessors\";\nimport { PlTreeEntry, PlTreeEntryAccessor } from \"./accessors\";\nimport type { ComputableCtx } from \"@milaboratories/computable\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/**\n * A DTO that can be generated from a tree node to make a snapshot of specific parts of it's state.\n * Such snapshots can then be used in core that requires this information without the need of\n * retrieving state from the tree.\n */\nexport type ResourceSnapshot<\n  Data = undefined,\n  Fields extends Record<string, ResourceId | undefined> | undefined = undefined,\n  KV extends Record<string, unknown> | undefined = undefined,\n> = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** The most generic type of ResourceSnapshot. */\ntype ResourceSnapshotGeneric = ResourceSnapshot<\n  unknown,\n  Record<string, ResourceId | undefined> | undefined,\n  Record<string, unknown> | undefined\n>;\n\n/** Request that we'll pass to getResourceSnapshot function. We infer the type of ResourceSnapshot from this. */\nexport type ResourceSnapshotSchema<\n  Data extends ZodType | \"raw\" | undefined = undefined,\n  Fields extends Record<string, boolean> | undefined = undefined,\n  KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n> = {\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */\nexport function rsSchema<\n  const Data extends ZodType | \"raw\" | undefined = undefined,\n  const Fields extends Record<string, boolean> | undefined = undefined,\n  const KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n>(\n  schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>,\n): ResourceSnapshotSchema<Data, Fields, KV> {\n  return schema as any;\n}\n\n/** The most generic type of ResourceSnapshotSchema. */\ntype ResourceSnapshotSchemaGeneric = ResourceSnapshotSchema<\n  ZodType | \"raw\" | undefined,\n  Record<string, boolean> | undefined,\n  Record<string, ZodType | \"raw\"> | undefined\n>;\n\n/**\n * If Data is 'raw' in schema, we'll get bytes,\n * if it's Zod, we'll parse it via zod.\n * Or else we just got undefined in the field.\n */\ntype InferDataType<Data extends ZodType | \"raw\" | undefined> = Data extends \"raw\"\n  ? Uint8Array\n  : Data extends ZodType\n    ? z.infer<Data>\n    : undefined;\n\n/**\n * If Fields is a record of field names to booleans,\n * then if the value of the field is true, we'll require this field and throw a Error if it wasn't found.\n * If it's false and doesn't exist, we'll return undefined.\n * If Fields type is undefined, we won't set fields at all.\n */\ntype InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof Fields]: Fields[FieldName] extends true\n        ? ResourceId\n        : ResourceId | undefined;\n    };\n\n/**\n * If KV is undefined, won't set it.\n * If one of values is Zod, we'll get KV and converts it to Zod schema.\n * If the value is 'raw', just returns bytes.\n */\ntype InferKVType<KV extends Record<string, ZodType | \"raw\"> | undefined> = KV extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array;\n    };\n\n/** Infer ResourceSnapshot from ResourceShapshotSchema, S can be any ResourceSnapshotSchema. */\nexport type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<\n  InferDataType<S[\"data\"]>,\n  InferFieldsType<S[\"fields\"]>,\n  InferKVType<S[\"kv\"]>\n>;\n\n/** Gets a ResourceSnapshot from PlTreeEntry. */\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry,\n  schema: Schema,\n  ctx: ComputableCtx,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry | PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n  ctx?: ComputableCtx,\n): InferSnapshot<Schema> {\n  const node =\n    res instanceof PlTreeEntry\n      ? notEmpty(ctx).accessor(res).node()\n      : res instanceof PlTreeEntryAccessor\n        ? res.node()\n        : res;\n  const info = node.resourceInfo;\n  const result: Optional<Writable<ResourceSnapshotGeneric>, \"data\" | \"fields\" | \"kv\"> = { ...info };\n\n  if (schema.data !== undefined) {\n    if (schema.data === \"raw\") result.data = node.getData();\n    else result.data = schema.data.parse(node.getDataAsJson());\n  }\n\n  if (schema.fields !== undefined) {\n    const fields: Record<string, ResourceId | undefined> = {};\n    // even if field is not defined, corresponding object field\n    // with \"undefined\" value will still be added\n    for (const [fieldName, required] of Object.entries(schema.fields))\n      fields[fieldName] = node.traverse({\n        field: fieldName,\n        errorIfFieldNotSet: required,\n        stableIfNotFound: !required,\n      })?.id;\n    result.fields = fields;\n  }\n\n  if (schema.kv !== undefined) {\n    const kv: Record<string, unknown> = {};\n    for (const [fieldName, type] of Object.entries(schema.kv)) {\n      const value = node.getKeyValue(fieldName);\n\n      if (value === undefined) {\n        throw new Error(`Key not found ${fieldName}`);\n      } else if (type === \"raw\") {\n        kv[fieldName] = value;\n      } else {\n        kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString(\"utf-8\")));\n      }\n    }\n    result.kv = kv;\n  }\n\n  return result as any;\n}\n\n/** @deprecated */\nexport type ResourceWithData = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly fields: Map<string, ResourceId | undefined>;\n  readonly data?: Uint8Array;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithData(\n  res: PlTreeEntry | ResourceWithData,\n  fields: string[],\n  ctx: ComputableCtx,\n): ResourceWithData {\n  if (res instanceof PlTreeEntry) {\n    const node = ctx.accessor(res).node();\n    const info = node.resourceInfo;\n\n    const fValues: [string, ResourceId | undefined][] = fields.map((name) => [\n      name,\n      node.getField(name)?.value?.id,\n    ]);\n\n    return {\n      ...info,\n      fields: new Map(fValues),\n      data: node.getData() ?? new Uint8Array(),\n    };\n  }\n\n  return res;\n}\n\n/** @deprecated */\nexport type ResourceWithMetadata = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly metadata: Record<string, any>;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithMetadata(\n  res: PlTreeEntry | ResourceWithMetadata,\n  mdKeys: string[],\n  ctx: ComputableCtx,\n): ResourceWithMetadata {\n  if (!(res instanceof PlTreeEntry)) return res;\n\n  const node = ctx.accessor(res).node();\n  const info = node.resourceInfo;\n  const mdEntries: [string, any][] = mdKeys.map((k) => [k, node.getKeyValue(k)]);\n\n  return {\n    ...info,\n    metadata: Object.fromEntries(mdEntries),\n  };\n}\n"],"mappings":";;;;;;AA4CA,SAAgB,SAKd,QAC0C;AAC1C,QAAO;;AA+DT,SAAgB,qBACd,KACA,QACA,KACuB;CACvB,MAAM,OACJ,eAAeA,yEACF,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,GAClC,eAAeC,wCACb,IAAI,MAAM,GACV;CAER,MAAM,SAAgF,EAAE,GAD3E,KAAK,cAC+E;AAEjG,KAAI,OAAO,SAAS,OAClB,KAAI,OAAO,SAAS,MAAO,QAAO,OAAO,KAAK,SAAS;KAClD,QAAO,OAAO,OAAO,KAAK,MAAM,KAAK,eAAe,CAAC;AAG5D,KAAI,OAAO,WAAW,QAAW;EAC/B,MAAM,SAAiD,EAAE;AAGzD,OAAK,MAAM,CAAC,WAAW,aAAa,OAAO,QAAQ,OAAO,OAAO,CAC/D,QAAO,aAAa,KAAK,SAAS;GAChC,OAAO;GACP,oBAAoB;GACpB,kBAAkB,CAAC;GACpB,CAAC,EAAE;AACN,SAAO,SAAS;;AAGlB,KAAI,OAAO,OAAO,QAAW;EAC3B,MAAM,KAA8B,EAAE;AACtC,OAAK,MAAM,CAAC,WAAW,SAAS,OAAO,QAAQ,OAAO,GAAG,EAAE;GACzD,MAAM,QAAQ,KAAK,YAAY,UAAU;AAEzC,OAAI,UAAU,OACZ,OAAM,IAAI,MAAM,iBAAiB,YAAY;YACpC,SAAS,MAClB,IAAG,aAAa;OAEhB,IAAG,aAAa,KAAK,MAAM,KAAK,MAAM,OAAO,KAAK,MAAM,CAAC,SAAS,QAAQ,CAAC,CAAC;;AAGhF,SAAO,KAAK;;AAGd,QAAO;;;AAYT,SAAgB,4BACd,KACA,QACA,KACkB;AAClB,KAAI,eAAeD,+BAAa;EAC9B,MAAM,OAAO,IAAI,SAAS,IAAI,CAAC,MAAM;EACrC,MAAM,OAAO,KAAK;EAElB,MAAM,UAA8C,OAAO,KAAK,SAAS,CACvE,MACA,KAAK,SAAS,KAAK,EAAE,OAAO,GAC7B,CAAC;AAEF,SAAO;GACL,GAAG;GACH,QAAQ,IAAI,IAAI,QAAQ;GACxB,MAAM,KAAK,SAAS,IAAI,IAAI,YAAY;GACzC;;AAGH,QAAO;;;AAWT,SAAgB,gCACd,KACA,QACA,KACsB;AACtB,KAAI,EAAE,eAAeA,+BAAc,QAAO;CAE1C,MAAM,OAAO,IAAI,SAAS,IAAI,CAAC,MAAM;CACrC,MAAM,OAAO,KAAK;CAClB,MAAM,YAA6B,OAAO,KAAK,MAAM,CAAC,GAAG,KAAK,YAAY,EAAE,CAAC,CAAC;AAE9E,QAAO;EACL,GAAG;EACH,UAAU,OAAO,YAAY,UAAU;EACxC"}

package/dist/snapshot.d.ts

@@ -1,29 +1,30 @@
-import type { ResourceId, ResourceType } from "@milaboratories/pl-client";
-import type { Optional } from "utility-types";
-import type { ZodType, z } from "zod";
-import type { PlTreeNodeAccessor } from "./accessors";
-import { PlTreeEntry, PlTreeEntryAccessor } from "./accessors";
-import type { ComputableCtx } from "@milaboratories/computable";
+import { PlTreeEntry, PlTreeEntryAccessor, PlTreeNodeAccessor } from "./accessors.js";
+import { ResourceId, ResourceType } from "@milaboratories/pl-client";
+import { ComputableCtx } from "@milaboratories/computable";
+import { Optional } from "utility-types";
+import { ZodType, z } from "zod";
+
+//#region src/snapshot.d.ts
 /**
  * A DTO that can be generated from a tree node to make a snapshot of specific parts of it's state.
  * Such snapshots can then be used in core that requires this information without the need of
  * retrieving state from the tree.
  */
-export type ResourceSnapshot<Data = undefined, Fields extends Record<string, ResourceId | undefined> | undefined = undefined, KV extends Record<string, unknown> | undefined = undefined> = {
-    readonly id: ResourceId;
-    readonly type: ResourceType;
-    readonly data: Data;
-    readonly fields: Fields;
-    readonly kv: KV;
+type ResourceSnapshot<Data = undefined, Fields extends Record<string, ResourceId | undefined> | undefined = undefined, KV extends Record<string, unknown> | undefined = undefined> = {
+  readonly id: ResourceId;
+  readonly type: ResourceType;
+  readonly data: Data;
+  readonly fields: Fields;
+  readonly kv: KV;
 };
 /** Request that we'll pass to getResourceSnapshot function. We infer the type of ResourceSnapshot from this. */
-export type ResourceSnapshotSchema<Data extends ZodType | "raw" | undefined = undefined, Fields extends Record<string, boolean> | undefined = undefined, KV extends Record<string, ZodType | "raw"> | undefined = undefined> = {
-    readonly data: Data;
-    readonly fields: Fields;
-    readonly kv: KV;
+type ResourceSnapshotSchema<Data extends ZodType | "raw" | undefined = undefined, Fields extends Record<string, boolean> | undefined = undefined, KV extends Record<string, ZodType | "raw"> | undefined = undefined> = {
+  readonly data: Data;
+  readonly fields: Fields;
+  readonly kv: KV;
 };
 /** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */
-export declare function rsSchema<const Data extends ZodType | "raw" | undefined = undefined, const Fields extends Record<string, boolean> | undefined = undefined, const KV extends Record<string, ZodType | "raw"> | undefined = undefined>(schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>): ResourceSnapshotSchema<Data, Fields, KV>;
+declare function rsSchema<const Data extends ZodType | "raw" | undefined = undefined, const Fields extends Record<string, boolean> | undefined = undefined, const KV extends Record<string, ZodType | "raw"> | undefined = undefined>(schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>): ResourceSnapshotSchema<Data, Fields, KV>;
 /** The most generic type of ResourceSnapshotSchema. */
 type ResourceSnapshotSchemaGeneric = ResourceSnapshotSchema<ZodType | "raw" | undefined, Record<string, boolean> | undefined, Record<string, ZodType | "raw"> | undefined>;
 /**
@@ -38,38 +39,35 @@ type InferDataType<Data extends ZodType | "raw" | undefined> = Data extends "raw
  * If it's false and doesn't exist, we'll return undefined.
  * If Fields type is undefined, we won't set fields at all.
  */
-type InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined ? undefined : {
-    [FieldName in keyof Fields]: Fields[FieldName] extends true ? ResourceId : ResourceId | undefined;
-};
+type InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined ? undefined : { [FieldName in keyof Fields]: Fields[FieldName] extends true ? ResourceId : ResourceId | undefined };
 /**
  * If KV is undefined, won't set it.
  * If one of values is Zod, we'll get KV and converts it to Zod schema.
  * If the value is 'raw', just returns bytes.
  */
-type InferKVType<KV extends Record<string, ZodType | "raw"> | undefined> = KV extends undefined ? undefined : {
-    [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array;
-};
+type InferKVType<KV extends Record<string, ZodType | "raw"> | undefined> = KV extends undefined ? undefined : { [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array };
 /** Infer ResourceSnapshot from ResourceShapshotSchema, S can be any ResourceSnapshotSchema. */
-export type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<InferDataType<S["data"]>, InferFieldsType<S["fields"]>, InferKVType<S["kv"]>>;
+type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<InferDataType<S["data"]>, InferFieldsType<S["fields"]>, InferKVType<S["kv"]>>;
 /** Gets a ResourceSnapshot from PlTreeEntry. */
-export declare function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(res: PlTreeEntry, schema: Schema, ctx: ComputableCtx): InferSnapshot<Schema>;
-export declare function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(res: PlTreeEntryAccessor | PlTreeNodeAccessor, schema: Schema): InferSnapshot<Schema>;
+declare function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(res: PlTreeEntry, schema: Schema, ctx: ComputableCtx): InferSnapshot<Schema>;
+declare function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(res: PlTreeEntryAccessor | PlTreeNodeAccessor, schema: Schema): InferSnapshot<Schema>;
 /** @deprecated */
-export type ResourceWithData = {
-    readonly id: ResourceId;
-    readonly type: ResourceType;
-    readonly fields: Map<string, ResourceId | undefined>;
-    readonly data?: Uint8Array;
+type ResourceWithData = {
+  readonly id: ResourceId;
+  readonly type: ResourceType;
+  readonly fields: Map<string, ResourceId | undefined>;
+  readonly data?: Uint8Array;
 };
 /** @deprecated */
-export declare function treeEntryToResourceWithData(res: PlTreeEntry | ResourceWithData, fields: string[], ctx: ComputableCtx): ResourceWithData;
+declare function treeEntryToResourceWithData(res: PlTreeEntry | ResourceWithData, fields: string[], ctx: ComputableCtx): ResourceWithData;
 /** @deprecated */
-export type ResourceWithMetadata = {
-    readonly id: ResourceId;
-    readonly type: ResourceType;
-    readonly metadata: Record<string, any>;
+type ResourceWithMetadata = {
+  readonly id: ResourceId;
+  readonly type: ResourceType;
+  readonly metadata: Record<string, any>;
 };
 /** @deprecated */
-export declare function treeEntryToResourceWithMetadata(res: PlTreeEntry | ResourceWithMetadata, mdKeys: string[], ctx: ComputableCtx): ResourceWithMetadata;
-export {};
+declare function treeEntryToResourceWithMetadata(res: PlTreeEntry | ResourceWithMetadata, mdKeys: string[], ctx: ComputableCtx): ResourceWithMetadata;
+//#endregion
+export { InferSnapshot, ResourceSnapshot, ResourceSnapshotSchema, ResourceWithData, ResourceWithMetadata, makeResourceSnapshot, rsSchema, treeEntryToResourceWithData, treeEntryToResourceWithMetadata };
 //# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.js

@@ -1,83 +1,63 @@
-import { PlTreeEntry, PlTreeEntryAccessor } from './accessors.js';
-import { notEmpty } from '@milaboratories/ts-helpers';
+import { PlTreeEntry, PlTreeEntryAccessor } from "./accessors.js";
+import { notEmpty } from "@milaboratories/ts-helpers";
 
+//#region src/snapshot.ts
 /** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */
 function rsSchema(schema) {
-    return schema;
+	return schema;
 }
 function makeResourceSnapshot(res, schema, ctx) {
-    const node = res instanceof PlTreeEntry
-        ? notEmpty(ctx).accessor(res).node()
-        : res instanceof PlTreeEntryAccessor
-            ? res.node()
-            : res;
-    const info = node.resourceInfo;
-    const result = { ...info };
-    if (schema.data !== undefined) {
-        if (schema.data === "raw")
-            result.data = node.getData();
-        else
-            result.data = schema.data.parse(node.getDataAsJson());
-    }
-    if (schema.fields !== undefined) {
-        const fields = {};
-        // even if field is not defined, corresponding object field
-        // with "undefined" value will still be added
-        for (const [fieldName, required] of Object.entries(schema.fields))
-            fields[fieldName] = node.traverse({
-                field: fieldName,
-                errorIfFieldNotSet: required,
-                stableIfNotFound: !required,
-            })?.id;
-        result.fields = fields;
-    }
-    if (schema.kv !== undefined) {
-        const kv = {};
-        for (const [fieldName, type] of Object.entries(schema.kv)) {
-            const value = node.getKeyValue(fieldName);
-            if (value === undefined) {
-                throw new Error(`Key not found ${fieldName}`);
-            }
-            else if (type === "raw") {
-                kv[fieldName] = value;
-            }
-            else {
-                kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString("utf-8")));
-            }
-        }
-        result.kv = kv;
-    }
-    return result;
+	const node = res instanceof PlTreeEntry ? notEmpty(ctx).accessor(res).node() : res instanceof PlTreeEntryAccessor ? res.node() : res;
+	const result = { ...node.resourceInfo };
+	if (schema.data !== void 0) if (schema.data === "raw") result.data = node.getData();
+	else result.data = schema.data.parse(node.getDataAsJson());
+	if (schema.fields !== void 0) {
+		const fields = {};
+		for (const [fieldName, required] of Object.entries(schema.fields)) fields[fieldName] = node.traverse({
+			field: fieldName,
+			errorIfFieldNotSet: required,
+			stableIfNotFound: !required
+		})?.id;
+		result.fields = fields;
+	}
+	if (schema.kv !== void 0) {
+		const kv = {};
+		for (const [fieldName, type] of Object.entries(schema.kv)) {
+			const value = node.getKeyValue(fieldName);
+			if (value === void 0) throw new Error(`Key not found ${fieldName}`);
+			else if (type === "raw") kv[fieldName] = value;
+			else kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString("utf-8")));
+		}
+		result.kv = kv;
+	}
+	return result;
 }
 /** @deprecated */
 function treeEntryToResourceWithData(res, fields, ctx) {
-    if (res instanceof PlTreeEntry) {
-        const node = ctx.accessor(res).node();
-        const info = node.resourceInfo;
-        const fValues = fields.map((name) => [
-            name,
-            node.getField(name)?.value?.id,
-        ]);
-        return {
-            ...info,
-            fields: new Map(fValues),
-            data: node.getData() ?? new Uint8Array(),
-        };
-    }
-    return res;
+	if (res instanceof PlTreeEntry) {
+		const node = ctx.accessor(res).node();
+		const info = node.resourceInfo;
+		const fValues = fields.map((name) => [name, node.getField(name)?.value?.id]);
+		return {
+			...info,
+			fields: new Map(fValues),
+			data: node.getData() ?? new Uint8Array()
+		};
+	}
+	return res;
 }
 /** @deprecated */
 function treeEntryToResourceWithMetadata(res, mdKeys, ctx) {
-    if (!(res instanceof PlTreeEntry))
-        return res;
-    const node = ctx.accessor(res).node();
-    const info = node.resourceInfo;
-    const mdEntries = mdKeys.map((k) => [k, node.getKeyValue(k)]);
-    return {
-        ...info,
-        metadata: Object.fromEntries(mdEntries),
-    };
+	if (!(res instanceof PlTreeEntry)) return res;
+	const node = ctx.accessor(res).node();
+	const info = node.resourceInfo;
+	const mdEntries = mdKeys.map((k) => [k, node.getKeyValue(k)]);
+	return {
+		...info,
+		metadata: Object.fromEntries(mdEntries)
+	};
 }
 
+//#endregion
 export { makeResourceSnapshot, rsSchema, treeEntryToResourceWithData, treeEntryToResourceWithMetadata };
-//# sourceMappingURL=snapshot.js.map
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sources":["../src/snapshot.ts"],"sourcesContent":["import type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport type { Optional, Writable } from \"utility-types\";\nimport type { ZodType, z } from \"zod\";\nimport type { PlTreeNodeAccessor } from \"./accessors\";\nimport { PlTreeEntry, PlTreeEntryAccessor } from \"./accessors\";\nimport type { ComputableCtx } from \"@milaboratories/computable\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/**\n * A DTO that can be generated from a tree node to make a snapshot of specific parts of it's state.\n * Such snapshots can then be used in core that requires this information without the need of\n * retrieving state from the tree.\n */\nexport type ResourceSnapshot<\n  Data = undefined,\n  Fields extends Record<string, ResourceId | undefined> | undefined = undefined,\n  KV extends Record<string, unknown> | undefined = undefined,\n> = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** The most generic type of ResourceSnapshot. */\ntype ResourceSnapshotGeneric = ResourceSnapshot<\n  unknown,\n  Record<string, ResourceId | undefined> | undefined,\n  Record<string, unknown> | undefined\n>;\n\n/** Request that we'll pass to getResourceSnapshot function. We infer the type of ResourceSnapshot from this. */\nexport type ResourceSnapshotSchema<\n  Data extends ZodType | \"raw\" | undefined = undefined,\n  Fields extends Record<string, boolean> | undefined = undefined,\n  KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n> = {\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */\nexport function rsSchema<\n  const Data extends ZodType | \"raw\" | undefined = undefined,\n  const Fields extends Record<string, boolean> | undefined = undefined,\n  const KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n>(\n  schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>,\n): ResourceSnapshotSchema<Data, Fields, KV> {\n  return schema as any;\n}\n\n/** The most generic type of ResourceSnapshotSchema. */\ntype ResourceSnapshotSchemaGeneric = ResourceSnapshotSchema<\n  ZodType | \"raw\" | undefined,\n  Record<string, boolean> | undefined,\n  Record<string, ZodType | \"raw\"> | undefined\n>;\n\n/**\n * If Data is 'raw' in schema, we'll get bytes,\n * if it's Zod, we'll parse it via zod.\n * Or else we just got undefined in the field.\n */\ntype InferDataType<Data extends ZodType | \"raw\" | undefined> = Data extends \"raw\"\n  ? Uint8Array\n  : Data extends ZodType\n    ? z.infer<Data>\n    : undefined;\n\n/**\n * If Fields is a record of field names to booleans,\n * then if the value of the field is true, we'll require this field and throw a Error if it wasn't found.\n * If it's false and doesn't exist, we'll return undefined.\n * If Fields type is undefined, we won't set fields at all.\n */\ntype InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof Fields]: Fields[FieldName] extends true\n        ? ResourceId\n        : ResourceId | undefined;\n    };\n\n/**\n * If KV is undefined, won't set it.\n * If one of values is Zod, we'll get KV and converts it to Zod schema.\n * If the value is 'raw', just returns bytes.\n */\ntype InferKVType<KV extends Record<string, ZodType | \"raw\"> | undefined> = KV extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array;\n    };\n\n/** Infer ResourceSnapshot from ResourceShapshotSchema, S can be any ResourceSnapshotSchema. */\nexport type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<\n  InferDataType<S[\"data\"]>,\n  InferFieldsType<S[\"fields\"]>,\n  InferKVType<S[\"kv\"]>\n>;\n\n/** Gets a ResourceSnapshot from PlTreeEntry. */\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry,\n  schema: Schema,\n  ctx: ComputableCtx,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry | PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n  ctx?: ComputableCtx,\n): InferSnapshot<Schema> {\n  const node =\n    res instanceof PlTreeEntry\n      ? notEmpty(ctx).accessor(res).node()\n      : res instanceof PlTreeEntryAccessor\n        ? res.node()\n        : res;\n  const info = node.resourceInfo;\n  const result: Optional<Writable<ResourceSnapshotGeneric>, \"data\" | \"fields\" | \"kv\"> = { ...info };\n\n  if (schema.data !== undefined) {\n    if (schema.data === \"raw\") result.data = node.getData();\n    else result.data = schema.data.parse(node.getDataAsJson());\n  }\n\n  if (schema.fields !== undefined) {\n    const fields: Record<string, ResourceId | undefined> = {};\n    // even if field is not defined, corresponding object field\n    // with \"undefined\" value will still be added\n    for (const [fieldName, required] of Object.entries(schema.fields))\n      fields[fieldName] = node.traverse({\n        field: fieldName,\n        errorIfFieldNotSet: required,\n        stableIfNotFound: !required,\n      })?.id;\n    result.fields = fields;\n  }\n\n  if (schema.kv !== undefined) {\n    const kv: Record<string, unknown> = {};\n    for (const [fieldName, type] of Object.entries(schema.kv)) {\n      const value = node.getKeyValue(fieldName);\n\n      if (value === undefined) {\n        throw new Error(`Key not found ${fieldName}`);\n      } else if (type === \"raw\") {\n        kv[fieldName] = value;\n      } else {\n        kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString(\"utf-8\")));\n      }\n    }\n    result.kv = kv;\n  }\n\n  return result as any;\n}\n\n/** @deprecated */\nexport type ResourceWithData = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly fields: Map<string, ResourceId | undefined>;\n  readonly data?: Uint8Array;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithData(\n  res: PlTreeEntry | ResourceWithData,\n  fields: string[],\n  ctx: ComputableCtx,\n): ResourceWithData {\n  if (res instanceof PlTreeEntry) {\n    const node = ctx.accessor(res).node();\n    const info = node.resourceInfo;\n\n    const fValues: [string, ResourceId | undefined][] = fields.map((name) => [\n      name,\n      node.getField(name)?.value?.id,\n    ]);\n\n    return {\n      ...info,\n      fields: new Map(fValues),\n      data: node.getData() ?? new Uint8Array(),\n    };\n  }\n\n  return res;\n}\n\n/** @deprecated */\nexport type ResourceWithMetadata = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly metadata: Record<string, any>;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithMetadata(\n  res: PlTreeEntry | ResourceWithMetadata,\n  mdKeys: string[],\n  ctx: ComputableCtx,\n): ResourceWithMetadata {\n  if (!(res instanceof PlTreeEntry)) return res;\n\n  const node = ctx.accessor(res).node();\n  const info = node.resourceInfo;\n  const mdEntries: [string, any][] = mdKeys.map((k) => [k, node.getKeyValue(k)]);\n\n  return {\n    ...info,\n    metadata: Object.fromEntries(mdEntries),\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.js","names":[],"sources":["../src/snapshot.ts"],"sourcesContent":["import type { ResourceId, ResourceType } from \"@milaboratories/pl-client\";\nimport type { Optional, Writable } from \"utility-types\";\nimport type { ZodType, z } from \"zod\";\nimport type { PlTreeNodeAccessor } from \"./accessors\";\nimport { PlTreeEntry, PlTreeEntryAccessor } from \"./accessors\";\nimport type { ComputableCtx } from \"@milaboratories/computable\";\nimport { notEmpty } from \"@milaboratories/ts-helpers\";\n\n/**\n * A DTO that can be generated from a tree node to make a snapshot of specific parts of it's state.\n * Such snapshots can then be used in core that requires this information without the need of\n * retrieving state from the tree.\n */\nexport type ResourceSnapshot<\n  Data = undefined,\n  Fields extends Record<string, ResourceId | undefined> | undefined = undefined,\n  KV extends Record<string, unknown> | undefined = undefined,\n> = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** The most generic type of ResourceSnapshot. */\ntype ResourceSnapshotGeneric = ResourceSnapshot<\n  unknown,\n  Record<string, ResourceId | undefined> | undefined,\n  Record<string, unknown> | undefined\n>;\n\n/** Request that we'll pass to getResourceSnapshot function. We infer the type of ResourceSnapshot from this. */\nexport type ResourceSnapshotSchema<\n  Data extends ZodType | \"raw\" | undefined = undefined,\n  Fields extends Record<string, boolean> | undefined = undefined,\n  KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n> = {\n  readonly data: Data;\n  readonly fields: Fields;\n  readonly kv: KV;\n};\n\n/** Creates ResourceSnapshotSchema. It converts an optional schema type to schema type. */\nexport function rsSchema<\n  const Data extends ZodType | \"raw\" | undefined = undefined,\n  const Fields extends Record<string, boolean> | undefined = undefined,\n  const KV extends Record<string, ZodType | \"raw\"> | undefined = undefined,\n>(\n  schema: Optional<ResourceSnapshotSchema<Data, Fields, KV>>,\n): ResourceSnapshotSchema<Data, Fields, KV> {\n  return schema as any;\n}\n\n/** The most generic type of ResourceSnapshotSchema. */\ntype ResourceSnapshotSchemaGeneric = ResourceSnapshotSchema<\n  ZodType | \"raw\" | undefined,\n  Record<string, boolean> | undefined,\n  Record<string, ZodType | \"raw\"> | undefined\n>;\n\n/**\n * If Data is 'raw' in schema, we'll get bytes,\n * if it's Zod, we'll parse it via zod.\n * Or else we just got undefined in the field.\n */\ntype InferDataType<Data extends ZodType | \"raw\" | undefined> = Data extends \"raw\"\n  ? Uint8Array\n  : Data extends ZodType\n    ? z.infer<Data>\n    : undefined;\n\n/**\n * If Fields is a record of field names to booleans,\n * then if the value of the field is true, we'll require this field and throw a Error if it wasn't found.\n * If it's false and doesn't exist, we'll return undefined.\n * If Fields type is undefined, we won't set fields at all.\n */\ntype InferFieldsType<Fields extends Record<string, boolean> | undefined> = Fields extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof Fields]: Fields[FieldName] extends true\n        ? ResourceId\n        : ResourceId | undefined;\n    };\n\n/**\n * If KV is undefined, won't set it.\n * If one of values is Zod, we'll get KV and converts it to Zod schema.\n * If the value is 'raw', just returns bytes.\n */\ntype InferKVType<KV extends Record<string, ZodType | \"raw\"> | undefined> = KV extends undefined\n  ? undefined\n  : {\n      [FieldName in keyof KV]: KV[FieldName] extends ZodType ? z.infer<KV[FieldName]> : Uint8Array;\n    };\n\n/** Infer ResourceSnapshot from ResourceShapshotSchema, S can be any ResourceSnapshotSchema. */\nexport type InferSnapshot<S extends ResourceSnapshotSchemaGeneric> = ResourceSnapshot<\n  InferDataType<S[\"data\"]>,\n  InferFieldsType<S[\"fields\"]>,\n  InferKVType<S[\"kv\"]>\n>;\n\n/** Gets a ResourceSnapshot from PlTreeEntry. */\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry,\n  schema: Schema,\n  ctx: ComputableCtx,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n): InferSnapshot<Schema>;\nexport function makeResourceSnapshot<Schema extends ResourceSnapshotSchemaGeneric>(\n  res: PlTreeEntry | PlTreeEntryAccessor | PlTreeNodeAccessor,\n  schema: Schema,\n  ctx?: ComputableCtx,\n): InferSnapshot<Schema> {\n  const node =\n    res instanceof PlTreeEntry\n      ? notEmpty(ctx).accessor(res).node()\n      : res instanceof PlTreeEntryAccessor\n        ? res.node()\n        : res;\n  const info = node.resourceInfo;\n  const result: Optional<Writable<ResourceSnapshotGeneric>, \"data\" | \"fields\" | \"kv\"> = { ...info };\n\n  if (schema.data !== undefined) {\n    if (schema.data === \"raw\") result.data = node.getData();\n    else result.data = schema.data.parse(node.getDataAsJson());\n  }\n\n  if (schema.fields !== undefined) {\n    const fields: Record<string, ResourceId | undefined> = {};\n    // even if field is not defined, corresponding object field\n    // with \"undefined\" value will still be added\n    for (const [fieldName, required] of Object.entries(schema.fields))\n      fields[fieldName] = node.traverse({\n        field: fieldName,\n        errorIfFieldNotSet: required,\n        stableIfNotFound: !required,\n      })?.id;\n    result.fields = fields;\n  }\n\n  if (schema.kv !== undefined) {\n    const kv: Record<string, unknown> = {};\n    for (const [fieldName, type] of Object.entries(schema.kv)) {\n      const value = node.getKeyValue(fieldName);\n\n      if (value === undefined) {\n        throw new Error(`Key not found ${fieldName}`);\n      } else if (type === \"raw\") {\n        kv[fieldName] = value;\n      } else {\n        kv[fieldName] = type.parse(JSON.parse(Buffer.from(value).toString(\"utf-8\")));\n      }\n    }\n    result.kv = kv;\n  }\n\n  return result as any;\n}\n\n/** @deprecated */\nexport type ResourceWithData = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly fields: Map<string, ResourceId | undefined>;\n  readonly data?: Uint8Array;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithData(\n  res: PlTreeEntry | ResourceWithData,\n  fields: string[],\n  ctx: ComputableCtx,\n): ResourceWithData {\n  if (res instanceof PlTreeEntry) {\n    const node = ctx.accessor(res).node();\n    const info = node.resourceInfo;\n\n    const fValues: [string, ResourceId | undefined][] = fields.map((name) => [\n      name,\n      node.getField(name)?.value?.id,\n    ]);\n\n    return {\n      ...info,\n      fields: new Map(fValues),\n      data: node.getData() ?? new Uint8Array(),\n    };\n  }\n\n  return res;\n}\n\n/** @deprecated */\nexport type ResourceWithMetadata = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n  readonly metadata: Record<string, any>;\n};\n\n/** @deprecated */\nexport function treeEntryToResourceWithMetadata(\n  res: PlTreeEntry | ResourceWithMetadata,\n  mdKeys: string[],\n  ctx: ComputableCtx,\n): ResourceWithMetadata {\n  if (!(res instanceof PlTreeEntry)) return res;\n\n  const node = ctx.accessor(res).node();\n  const info = node.resourceInfo;\n  const mdEntries: [string, any][] = mdKeys.map((k) => [k, node.getKeyValue(k)]);\n\n  return {\n    ...info,\n    metadata: Object.fromEntries(mdEntries),\n  };\n}\n"],"mappings":";;;;;AA4CA,SAAgB,SAKd,QAC0C;AAC1C,QAAO;;AA+DT,SAAgB,qBACd,KACA,QACA,KACuB;CACvB,MAAM,OACJ,eAAe,cACX,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,GAClC,eAAe,sBACb,IAAI,MAAM,GACV;CAER,MAAM,SAAgF,EAAE,GAD3E,KAAK,cAC+E;AAEjG,KAAI,OAAO,SAAS,OAClB,KAAI,OAAO,SAAS,MAAO,QAAO,OAAO,KAAK,SAAS;KAClD,QAAO,OAAO,OAAO,KAAK,MAAM,KAAK,eAAe,CAAC;AAG5D,KAAI,OAAO,WAAW,QAAW;EAC/B,MAAM,SAAiD,EAAE;AAGzD,OAAK,MAAM,CAAC,WAAW,aAAa,OAAO,QAAQ,OAAO,OAAO,CAC/D,QAAO,aAAa,KAAK,SAAS;GAChC,OAAO;GACP,oBAAoB;GACpB,kBAAkB,CAAC;GACpB,CAAC,EAAE;AACN,SAAO,SAAS;;AAGlB,KAAI,OAAO,OAAO,QAAW;EAC3B,MAAM,KAA8B,EAAE;AACtC,OAAK,MAAM,CAAC,WAAW,SAAS,OAAO,QAAQ,OAAO,GAAG,EAAE;GACzD,MAAM,QAAQ,KAAK,YAAY,UAAU;AAEzC,OAAI,UAAU,OACZ,OAAM,IAAI,MAAM,iBAAiB,YAAY;YACpC,SAAS,MAClB,IAAG,aAAa;OAEhB,IAAG,aAAa,KAAK,MAAM,KAAK,MAAM,OAAO,KAAK,MAAM,CAAC,SAAS,QAAQ,CAAC,CAAC;;AAGhF,SAAO,KAAK;;AAGd,QAAO;;;AAYT,SAAgB,4BACd,KACA,QACA,KACkB;AAClB,KAAI,eAAe,aAAa;EAC9B,MAAM,OAAO,IAAI,SAAS,IAAI,CAAC,MAAM;EACrC,MAAM,OAAO,KAAK;EAElB,MAAM,UAA8C,OAAO,KAAK,SAAS,CACvE,MACA,KAAK,SAAS,KAAK,EAAE,OAAO,GAC7B,CAAC;AAEF,SAAO;GACL,GAAG;GACH,QAAQ,IAAI,IAAI,QAAQ;GACxB,MAAM,KAAK,SAAS,IAAI,IAAI,YAAY;GACzC;;AAGH,QAAO;;;AAWT,SAAgB,gCACd,KACA,QACA,KACsB;AACtB,KAAI,EAAE,eAAe,aAAc,QAAO;CAE1C,MAAM,OAAO,IAAI,SAAS,IAAI,CAAC,MAAM;CACrC,MAAM,OAAO,KAAK;CAClB,MAAM,YAA6B,OAAO,KAAK,MAAM,CAAC,GAAG,KAAK,YAAY,EAAE,CAAC,CAAC;AAE9E,QAAO;EACL,GAAG;EACH,UAAU,OAAO,YAAY,UAAU;EACxC"}