@powerhousedao/reactor-attachments 6.2.3-dev.6 → 6.2.3-dev.61

package/dist/attachment-schema-compiler-rIaJpiHO.js

@@ -0,0 +1,262 @@
+import { a as parseRef } from "./switchboard-attachment-transport-BH3ZAmxE.js";
+import { generatorTypeDefs } from "@powerhousedao/document-engineering/graphql";
+import { constantCase, pascalCase } from "change-case";
+import { Kind, buildASTSchema, getNamedType, isInputObjectType, isListType, isNonNullType, parse, print } from "graphql";
+//#region src/reference-index/attachment-schema-compiler.ts
+const ATTACHMENT_REF_TYPE = "AttachmentRef";
+const CODEGEN_SCALAR_NAMES = /* @__PURE__ */ new Set([
+	"Unknown",
+	"DateTime",
+	"Address",
+	ATTACHMENT_REF_TYPE,
+	...Object.keys(generatorTypeDefs)
+]);
+function describeContext(context) {
+	return `document type "${context.documentType}", version ${context.version}, action "${context.actionType}"`;
+}
+function compilationError(context, reason) {
+	return /* @__PURE__ */ new Error(`Attachment schema compilation failed for ${describeContext(context)}: ${reason}`);
+}
+function extractionError(context, path, reason) {
+	return /* @__PURE__ */ new Error(`Attachment extraction failed for ${describeContext(context)} at ${path}: ${reason}`);
+}
+function applicableSpecification(module, context) {
+	const matches = module.documentModel.global.specifications.filter((specification) => specification.version === context.version);
+	if (matches.length !== 1) throw compilationError(context, matches.length === 0 ? "the module has no matching specification" : "the module has multiple matching specifications");
+	return matches[0];
+}
+function parseOperations(specification, context) {
+	return specification.modules.flatMap((moduleSpecification) => moduleSpecification.operations.map((operation) => {
+		if (operation.schema === null) return {
+			document: null,
+			operation
+		};
+		try {
+			return {
+				document: parse(operation.schema),
+				operation
+			};
+		} catch {
+			throw compilationError(context, "an operation has invalid GraphQL SDL");
+		}
+	}));
+}
+function selectOperation(operations, context) {
+	const matches = operations.filter(({ operation }) => operation.name !== null && constantCase(operation.name) === context.actionType);
+	if (matches.length > 1) throw compilationError(context, "multiple operations map to the action");
+	if (matches.length === 0) return null;
+	return matches[0];
+}
+function buildEffectiveSchema(specification, context) {
+	const scalarSchemas = Array.from(CODEGEN_SCALAR_NAMES, (name) => `scalar ${name}`);
+	const stateSchemas = Object.values(specification.state).map((state) => state.schema);
+	const operationSchemas = specification.modules.flatMap((moduleSpecification) => moduleSpecification.operations.flatMap((operation) => operation.schema === null ? [] : [operation.schema]));
+	try {
+		const document = parse([
+			...scalarSchemas,
+			...stateSchemas,
+			...operationSchemas
+		].filter(Boolean).join("\n\n"));
+		return buildASTSchema(dedupeTypeDefinitions(document));
+	} catch {
+		throw compilationError(context, "the effective GraphQL schema is invalid");
+	}
+}
+function dedupeTypeDefinitions(document) {
+	const seen = /* @__PURE__ */ new Map();
+	const definitions = document.definitions.filter((definition) => {
+		if (!("name" in definition) || definition.name?.value === void 0 || definition.kind === Kind.SCALAR_TYPE_DEFINITION) return true;
+		const name = definition.name.value;
+		const printed = print(definition);
+		const existing = seen.get(name);
+		if (existing === void 0) {
+			seen.set(name, printed);
+			return true;
+		}
+		return existing !== printed;
+	});
+	return {
+		...document,
+		definitions
+	};
+}
+function attachmentReachableTypes(definitions) {
+	const reachable = /* @__PURE__ */ new Set();
+	let changed = true;
+	while (changed) {
+		changed = false;
+		for (const [name, definition] of definitions) {
+			if (reachable.has(name)) continue;
+			if (Object.values(definition.getFields()).some((field) => {
+				const typeName = getNamedType(field.type).name;
+				return typeName === ATTACHMENT_REF_TYPE || definitions.has(typeName) && reachable.has(typeName);
+			})) {
+				reachable.add(name);
+				changed = true;
+			}
+		}
+	}
+	return reachable;
+}
+function compileValuePlan(type, objectPlans) {
+	if (isNonNullType(type)) return {
+		...compileValuePlan(type.ofType, objectPlans),
+		required: true
+	};
+	if (isListType(type)) return {
+		item: compileValuePlan(type.ofType, objectPlans),
+		kind: "list",
+		required: false
+	};
+	const typeName = type.name;
+	if (typeName === ATTACHMENT_REF_TYPE) return {
+		kind: "attachment",
+		required: false
+	};
+	const body = objectPlans.get(typeName);
+	if (!body) throw new Error(`Internal attachment schema plan error for ${typeName}`);
+	return {
+		body,
+		kind: "object",
+		required: false
+	};
+}
+function compileRootPlan(rootName, definitions) {
+	const reachable = attachmentReachableTypes(definitions);
+	if (!reachable.has(rootName)) return null;
+	const objectPlans = /* @__PURE__ */ new Map();
+	for (const name of reachable) objectPlans.set(name, { fields: [] });
+	for (const name of reachable) {
+		const definition = definitions.get(name);
+		const body = objectPlans.get(name);
+		if (!definition || !body) continue;
+		for (const field of Object.values(definition.getFields())) {
+			const typeName = getNamedType(field.type).name;
+			if (typeName !== ATTACHMENT_REF_TYPE && !reachable.has(typeName)) continue;
+			body.fields.push({
+				hasDefault: field.defaultValue !== void 0,
+				name: field.name,
+				value: compileValuePlan(field.type, objectPlans)
+			});
+		}
+	}
+	return objectPlans.get(rootName) ?? null;
+}
+function readOwnField(value, fieldName, context, path) {
+	try {
+		if (!Object.prototype.hasOwnProperty.call(value, fieldName)) return {
+			present: false,
+			value: void 0
+		};
+		return {
+			present: true,
+			value: value[fieldName]
+		};
+	} catch {
+		throw extractionError(context, path, "the declared field cannot be read");
+	}
+}
+function extractValue(plan, value, path, context, refs, seenRefs, activeObjects) {
+	if (value === null || value === void 0) {
+		if (plan.required) throw extractionError(context, path, "a required value is missing or null");
+		return;
+	}
+	if (plan.kind === "attachment") {
+		if (typeof value !== "string") throw extractionError(context, path, "expected an AttachmentRef string");
+		try {
+			parseRef(value);
+		} catch {
+			throw extractionError(context, path, "the AttachmentRef is malformed");
+		}
+		if (!seenRefs.has(value)) {
+			seenRefs.add(value);
+			refs.push(value);
+		}
+		return;
+	}
+	if (plan.kind === "list") {
+		if (!Array.isArray(value)) throw extractionError(context, path, "expected a list");
+		for (let index = 0; index < value.length; index += 1) extractValue(plan.item, value[index], `${path}[${index}]`, context, refs, seenRefs, activeObjects);
+		return;
+	}
+	if (typeof value !== "object" || Array.isArray(value)) throw extractionError(context, path, "expected an input object");
+	if (activeObjects.has(value)) throw extractionError(context, path, "the input value contains a cycle");
+	activeObjects.add(value);
+	try {
+		const record = value;
+		for (const field of plan.body.fields) {
+			const fieldPath = `${path}.${field.name}`;
+			const result = readOwnField(record, field.name, context, fieldPath);
+			if ((!result.present || result.value === void 0) && field.hasDefault) continue;
+			extractValue(field.value, result.value, fieldPath, context, refs, seenRefs, activeObjects);
+		}
+	} finally {
+		activeObjects.delete(value);
+	}
+}
+var SchemaCompiledAttachmentExtractor = class {
+	context;
+	rootPlan;
+	constructor(context, rootPlan) {
+		this.context = context;
+		this.rootPlan = rootPlan;
+	}
+	extract(action) {
+		if (action.type !== this.context.actionType) throw extractionError(this.context, "input", "the action type does not match the compiled schema");
+		if (!this.rootPlan) return [];
+		if (action.input === null || typeof action.input !== "object" || Array.isArray(action.input)) throw extractionError(this.context, "input", "expected an input object");
+		const refs = [];
+		const seenRefs = /* @__PURE__ */ new Set();
+		const activeObjects = /* @__PURE__ */ new WeakSet();
+		activeObjects.add(action.input);
+		try {
+			const input = action.input;
+			for (const field of this.rootPlan.fields) {
+				const path = `input.${field.name}`;
+				const result = readOwnField(input, field.name, this.context, path);
+				if ((!result.present || result.value === void 0) && field.hasDefault) continue;
+				extractValue(field.value, result.value, path, this.context, refs, seenRefs, activeObjects);
+			}
+		} finally {
+			activeObjects.delete(action.input);
+		}
+		return refs;
+	}
+};
+function compileExtractor(module, actionType) {
+	const context = {
+		actionType,
+		documentType: module.documentModel.global.id,
+		version: module.version ?? 1
+	};
+	const specification = applicableSpecification(module, context);
+	const selected = selectOperation(parseOperations(specification, context), context);
+	if (selected === null || selected.operation.schema === null) return new SchemaCompiledAttachmentExtractor(context, null);
+	const effectiveSchema = buildEffectiveSchema(specification, context);
+	const operationName = selected.operation.name;
+	if (operationName === null) throw compilationError(context, "the operation has no name");
+	const rootName = `${pascalCase(operationName)}Input`;
+	const definitions = /* @__PURE__ */ new Map();
+	for (const type of Object.values(effectiveSchema.getTypeMap())) if (isInputObjectType(type) && !type.name.startsWith("__")) definitions.set(type.name, type);
+	if (!(selected.document?.definitions.filter((definition) => (definition.kind === Kind.INPUT_OBJECT_TYPE_DEFINITION || definition.kind === Kind.INPUT_OBJECT_TYPE_EXTENSION) && definition.name.value === rootName))?.length || !definitions.has(rootName)) throw compilationError(context, `the operation does not declare its expected root input "${rootName}"`);
+	return new SchemaCompiledAttachmentExtractor(context, compileRootPlan(rootName, definitions));
+}
+var AttachmentSchemaCompiler = class {
+	cache = /* @__PURE__ */ new WeakMap();
+	forModuleAction(module, actionType) {
+		let moduleCache = this.cache.get(module);
+		if (!moduleCache) {
+			moduleCache = /* @__PURE__ */ new Map();
+			this.cache.set(module, moduleCache);
+		}
+		const cached = moduleCache.get(actionType);
+		if (cached) return cached;
+		const compiled = compileExtractor(module, actionType);
+		moduleCache.set(actionType, compiled);
+		return compiled;
+	}
+};
+//#endregion
+export { AttachmentSchemaCompiler as t };
+
+//# sourceMappingURL=attachment-schema-compiler-rIaJpiHO.js.map

package/dist/attachment-schema-compiler-rIaJpiHO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-schema-compiler-rIaJpiHO.js","names":[],"sources":["../src/reference-index/attachment-schema-compiler.ts"],"sourcesContent":["import type { AttachmentRef } from \"@powerhousedao/reactor\";\nimport { generatorTypeDefs } from \"@powerhousedao/document-engineering/graphql\";\nimport type {\n  Action,\n  DocumentModelModule,\n  DocumentSpecification,\n  OperationSpecification,\n} from \"@powerhousedao/shared/document-model\";\nimport { constantCase, pascalCase } from \"change-case\";\nimport {\n  buildASTSchema,\n  getNamedType,\n  isInputObjectType,\n  isListType,\n  isNonNullType,\n  Kind,\n  parse,\n  print,\n  type DocumentNode,\n  type GraphQLInputObjectType,\n  type GraphQLInputType,\n  type GraphQLSchema,\n} from \"graphql\";\nimport { parseRef } from \"../ref.js\";\nimport type {\n  CompiledAttachmentExtractor,\n  IAttachmentSchemaCompiler,\n} from \"./types.js\";\n\nconst ATTACHMENT_REF_TYPE = \"AttachmentRef\";\nconst CODEGEN_SCALAR_NAMES = new Set([\n  \"Unknown\",\n  \"DateTime\",\n  \"Address\",\n  ATTACHMENT_REF_TYPE,\n  ...Object.keys(generatorTypeDefs as Record<string, string>),\n]);\n\ntype CompilerContext = {\n  actionType: string;\n  documentType: string;\n  version: number;\n};\n\ntype ParsedOperation = {\n  document: DocumentNode | null;\n  operation: OperationSpecification;\n};\n\ntype ObjectPlan = {\n  fields: FieldPlan[];\n};\n\ntype FieldPlan = {\n  hasDefault: boolean;\n  name: string;\n  value: ValuePlan;\n};\n\ntype ReadFieldResult =\n  | { present: false; value: undefined }\n  | { present: true; value: unknown };\n\ntype ValuePlan =\n  | {\n      kind: \"attachment\";\n      required: boolean;\n    }\n  | {\n      item: ValuePlan;\n      kind: \"list\";\n      required: boolean;\n    }\n  | {\n      body: ObjectPlan;\n      kind: \"object\";\n      required: boolean;\n    };\n\nfunction describeContext(context: CompilerContext): string {\n  return `document type \"${context.documentType}\", version ${context.version}, action \"${context.actionType}\"`;\n}\n\nfunction compilationError(context: CompilerContext, reason: string): Error {\n  return new Error(\n    `Attachment schema compilation failed for ${describeContext(context)}: ${reason}`,\n  );\n}\n\nfunction extractionError(\n  context: CompilerContext,\n  path: string,\n  reason: string,\n): Error {\n  return new Error(\n    `Attachment extraction failed for ${describeContext(context)} at ${path}: ${reason}`,\n  );\n}\n\nfunction applicableSpecification(\n  module: DocumentModelModule,\n  context: CompilerContext,\n): DocumentSpecification {\n  const matches = module.documentModel.global.specifications.filter(\n    (specification) => specification.version === context.version,\n  );\n  if (matches.length !== 1) {\n    throw compilationError(\n      context,\n      matches.length === 0\n        ? \"the module has no matching specification\"\n        : \"the module has multiple matching specifications\",\n    );\n  }\n  return matches[0];\n}\n\nfunction parseOperations(\n  specification: DocumentSpecification,\n  context: CompilerContext,\n): ParsedOperation[] {\n  return specification.modules.flatMap((moduleSpecification) =>\n    moduleSpecification.operations.map((operation) => {\n      if (operation.schema === null) return { document: null, operation };\n      try {\n        return { document: parse(operation.schema), operation };\n      } catch {\n        throw compilationError(context, \"an operation has invalid GraphQL SDL\");\n      }\n    }),\n  );\n}\n\nfunction selectOperation(\n  operations: ParsedOperation[],\n  context: CompilerContext,\n): ParsedOperation | null {\n  const matches = operations.filter(\n    ({ operation }) =>\n      operation.name !== null &&\n      constantCase(operation.name) === context.actionType,\n  );\n  if (matches.length > 1) {\n    throw compilationError(context, \"multiple operations map to the action\");\n  }\n  // Base/system actions (document creation, renames, undo) are not part of a\n  // model's specification, so they cannot declare AttachmentRef fields.\n  // They compile to the no-reference fast path instead of failing the stream.\n  if (matches.length === 0) return null;\n  return matches[0];\n}\n\nfunction buildEffectiveSchema(\n  specification: DocumentSpecification,\n  context: CompilerContext,\n): GraphQLSchema {\n  const scalarSchemas = Array.from(\n    CODEGEN_SCALAR_NAMES,\n    (name) => `scalar ${name}`,\n  );\n  const stateSchemas = Object.values(specification.state).map(\n    (state) => state.schema,\n  );\n  const operationSchemas = specification.modules.flatMap(\n    (moduleSpecification) =>\n      moduleSpecification.operations.flatMap((operation) =>\n        operation.schema === null ? [] : [operation.schema],\n      ),\n  );\n\n  try {\n    const document = parse(\n      [...scalarSchemas, ...stateSchemas, ...operationSchemas]\n        .filter(Boolean)\n        .join(\"\\n\\n\"),\n    );\n    return buildASTSchema(dedupeTypeDefinitions(document));\n  } catch {\n    throw compilationError(context, \"the effective GraphQL schema is invalid\");\n  }\n}\n\n// Collapse identical repeats of a type (state schema vs operation schemas).\n// Conflicting or scalar duplicates stay in so the build still rejects them.\nfunction dedupeTypeDefinitions(document: DocumentNode): DocumentNode {\n  const seen = new Map<string, string>();\n  const definitions = document.definitions.filter((definition) => {\n    if (\n      !(\"name\" in definition) ||\n      definition.name?.value === undefined ||\n      definition.kind === Kind.SCALAR_TYPE_DEFINITION\n    ) {\n      return true;\n    }\n    const name = definition.name.value;\n    const printed = print(definition);\n    const existing = seen.get(name);\n    if (existing === undefined) {\n      seen.set(name, printed);\n      return true;\n    }\n    return existing !== printed;\n  });\n  return { ...document, definitions };\n}\n\nfunction attachmentReachableTypes(\n  definitions: Map<string, GraphQLInputObjectType>,\n): Set<string> {\n  const reachable = new Set<string>();\n  let changed = true;\n\n  while (changed) {\n    changed = false;\n    for (const [name, definition] of definitions) {\n      if (reachable.has(name)) continue;\n      const reachesAttachment = Object.values(definition.getFields()).some(\n        (field) => {\n          const typeName = getNamedType(field.type).name;\n          return (\n            typeName === ATTACHMENT_REF_TYPE ||\n            (definitions.has(typeName) && reachable.has(typeName))\n          );\n        },\n      );\n      if (reachesAttachment) {\n        reachable.add(name);\n        changed = true;\n      }\n    }\n  }\n\n  return reachable;\n}\n\nfunction compileValuePlan(\n  type: GraphQLInputType,\n  objectPlans: Map<string, ObjectPlan>,\n): ValuePlan {\n  if (isNonNullType(type)) {\n    return { ...compileValuePlan(type.ofType, objectPlans), required: true };\n  }\n  if (isListType(type)) {\n    return {\n      item: compileValuePlan(type.ofType, objectPlans),\n      kind: \"list\",\n      required: false,\n    };\n  }\n\n  const typeName = type.name;\n  if (typeName === ATTACHMENT_REF_TYPE) {\n    return { kind: \"attachment\", required: false };\n  }\n  const body = objectPlans.get(typeName);\n  if (!body) {\n    throw new Error(`Internal attachment schema plan error for ${typeName}`);\n  }\n  return { body, kind: \"object\", required: false };\n}\n\nfunction compileRootPlan(\n  rootName: string,\n  definitions: Map<string, GraphQLInputObjectType>,\n): ObjectPlan | null {\n  const reachable = attachmentReachableTypes(definitions);\n  if (!reachable.has(rootName)) return null;\n\n  const objectPlans = new Map<string, ObjectPlan>();\n  for (const name of reachable) objectPlans.set(name, { fields: [] });\n\n  for (const name of reachable) {\n    const definition = definitions.get(name);\n    const body = objectPlans.get(name);\n    if (!definition || !body) continue;\n    for (const field of Object.values(definition.getFields())) {\n      const typeName = getNamedType(field.type).name;\n      if (typeName !== ATTACHMENT_REF_TYPE && !reachable.has(typeName)) {\n        continue;\n      }\n      body.fields.push({\n        hasDefault: field.defaultValue !== undefined,\n        name: field.name,\n        value: compileValuePlan(field.type, objectPlans),\n      });\n    }\n  }\n\n  return objectPlans.get(rootName) ?? null;\n}\n\nfunction readOwnField(\n  value: Record<string, unknown>,\n  fieldName: string,\n  context: CompilerContext,\n  path: string,\n): ReadFieldResult {\n  try {\n    if (!Object.prototype.hasOwnProperty.call(value, fieldName)) {\n      return { present: false, value: undefined };\n    }\n    return { present: true, value: value[fieldName] };\n  } catch {\n    throw extractionError(context, path, \"the declared field cannot be read\");\n  }\n}\n\nfunction extractValue(\n  plan: ValuePlan,\n  value: unknown,\n  path: string,\n  context: CompilerContext,\n  refs: AttachmentRef[],\n  seenRefs: Set<string>,\n  activeObjects: WeakSet<object>,\n): void {\n  if (value === null || value === undefined) {\n    if (plan.required) {\n      throw extractionError(\n        context,\n        path,\n        \"a required value is missing or null\",\n      );\n    }\n    return;\n  }\n\n  if (plan.kind === \"attachment\") {\n    if (typeof value !== \"string\") {\n      throw extractionError(context, path, \"expected an AttachmentRef string\");\n    }\n    try {\n      parseRef(value as AttachmentRef);\n    } catch {\n      throw extractionError(context, path, \"the AttachmentRef is malformed\");\n    }\n    if (!seenRefs.has(value)) {\n      seenRefs.add(value);\n      refs.push(value as AttachmentRef);\n    }\n    return;\n  }\n\n  if (plan.kind === \"list\") {\n    if (!Array.isArray(value)) {\n      throw extractionError(context, path, \"expected a list\");\n    }\n    for (let index = 0; index < value.length; index += 1) {\n      extractValue(\n        plan.item,\n        value[index],\n        `${path}[${index}]`,\n        context,\n        refs,\n        seenRefs,\n        activeObjects,\n      );\n    }\n    return;\n  }\n\n  if (typeof value !== \"object\" || Array.isArray(value)) {\n    throw extractionError(context, path, \"expected an input object\");\n  }\n  if (activeObjects.has(value)) {\n    throw extractionError(context, path, \"the input value contains a cycle\");\n  }\n\n  activeObjects.add(value);\n  try {\n    const record = value as Record<string, unknown>;\n    for (const field of plan.body.fields) {\n      const fieldPath = `${path}.${field.name}`;\n      const result = readOwnField(record, field.name, context, fieldPath);\n      if ((!result.present || result.value === undefined) && field.hasDefault) {\n        continue;\n      }\n      extractValue(\n        field.value,\n        result.value,\n        fieldPath,\n        context,\n        refs,\n        seenRefs,\n        activeObjects,\n      );\n    }\n  } finally {\n    activeObjects.delete(value);\n  }\n}\n\nclass SchemaCompiledAttachmentExtractor implements CompiledAttachmentExtractor {\n  constructor(\n    private readonly context: CompilerContext,\n    private readonly rootPlan: ObjectPlan | null,\n  ) {}\n\n  extract(action: Action): AttachmentRef[] {\n    if (action.type !== this.context.actionType) {\n      throw extractionError(\n        this.context,\n        \"input\",\n        \"the action type does not match the compiled schema\",\n      );\n    }\n    if (!this.rootPlan) return [];\n    if (\n      action.input === null ||\n      typeof action.input !== \"object\" ||\n      Array.isArray(action.input)\n    ) {\n      throw extractionError(this.context, \"input\", \"expected an input object\");\n    }\n\n    const refs: AttachmentRef[] = [];\n    const seenRefs = new Set<string>();\n    const activeObjects = new WeakSet<object>();\n    activeObjects.add(action.input);\n    try {\n      const input = action.input as Record<string, unknown>;\n      for (const field of this.rootPlan.fields) {\n        const path = `input.${field.name}`;\n        const result = readOwnField(input, field.name, this.context, path);\n        if (\n          (!result.present || result.value === undefined) &&\n          field.hasDefault\n        ) {\n          continue;\n        }\n        extractValue(\n          field.value,\n          result.value,\n          path,\n          this.context,\n          refs,\n          seenRefs,\n          activeObjects,\n        );\n      }\n    } finally {\n      activeObjects.delete(action.input);\n    }\n    return refs;\n  }\n}\n\nfunction compileExtractor(\n  module: DocumentModelModule,\n  actionType: string,\n): CompiledAttachmentExtractor {\n  const context: CompilerContext = {\n    actionType,\n    documentType: module.documentModel.global.id,\n    version: module.version ?? 1,\n  };\n  const specification = applicableSpecification(module, context);\n  const operations = parseOperations(specification, context);\n  const selected = selectOperation(operations, context);\n  if (selected === null || selected.operation.schema === null) {\n    return new SchemaCompiledAttachmentExtractor(context, null);\n  }\n  const effectiveSchema = buildEffectiveSchema(specification, context);\n\n  const operationName = selected.operation.name;\n  if (operationName === null) {\n    throw compilationError(context, \"the operation has no name\");\n  }\n  const rootName = `${pascalCase(operationName)}Input`;\n  const definitions = new Map<string, GraphQLInputObjectType>();\n  for (const type of Object.values(effectiveSchema.getTypeMap())) {\n    if (isInputObjectType(type) && !type.name.startsWith(\"__\")) {\n      definitions.set(type.name, type);\n    }\n  }\n  const rootDefinitions = selected.document?.definitions.filter(\n    (definition) =>\n      (definition.kind === Kind.INPUT_OBJECT_TYPE_DEFINITION ||\n        definition.kind === Kind.INPUT_OBJECT_TYPE_EXTENSION) &&\n      definition.name.value === rootName,\n  );\n  if (!rootDefinitions?.length || !definitions.has(rootName)) {\n    throw compilationError(\n      context,\n      `the operation does not declare its expected root input \"${rootName}\"`,\n    );\n  }\n\n  return new SchemaCompiledAttachmentExtractor(\n    context,\n    compileRootPlan(rootName, definitions),\n  );\n}\n\nexport class AttachmentSchemaCompiler implements IAttachmentSchemaCompiler {\n  private readonly cache = new WeakMap<\n    DocumentModelModule,\n    Map<string, CompiledAttachmentExtractor>\n  >();\n\n  forModuleAction(\n    module: DocumentModelModule,\n    actionType: string,\n  ): CompiledAttachmentExtractor {\n    let moduleCache = this.cache.get(module);\n    if (!moduleCache) {\n      moduleCache = new Map();\n      this.cache.set(module, moduleCache);\n    }\n\n    const cached = moduleCache.get(actionType);\n    if (cached) return cached;\n\n    const compiled = compileExtractor(module, actionType);\n    moduleCache.set(actionType, compiled);\n    return compiled;\n  }\n}\n"],"mappings":"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"}

package/dist/client.d.ts

@@ -1,6 +1,6 @@
-import { $ as AttachmentPending, A as IReservationStore, B as AttachmentStatus, C as IAttachmentReader, D as IAttachmentTransportFactory, E as IAttachmentTransport, F as AttachmentDownloadTargetOptions, G as HashFirstReserveAttachmentOptions, H as AttachmentTransportConfig, I as AttachmentHeader, J as TransportFetchResult, K as Reservation, L as AttachmentMetadata, N as AttachmentDownloadOptions, O as IAttachmentUpload, P as AttachmentDownloadTarget, Q as AttachmentNotFound, R as AttachmentResponse, T as IAttachmentStore, U as AttachmentUploadResult, V as AttachmentTargetHeaders, W as AttachmentUploadTarget, X as UploadFirstReserveAttachmentOptions, Y as TransportResponse, Z as AttachmentAlreadyExists, _ as createRef, a as RemoteAttachmentUpload, at as SizeMismatch, b as parseAttachmentDownloadTarget, c as XhrUploadTransportOptions, d as AttachmentUploadResponse, et as AttachmentTransferError, f as AttachmentUploadTransport, g as ParsedRef, h as SwitchboardTransportConfig, i as RemoteAttachmentUploadFactory, it as ReservationNotFound, k as IAttachmentUploadFactory, l as createXhrUploadTransport, m as SwitchboardAttachmentTransport, n as createRemoteAttachmentService, nt as HashMismatch, o as RemoteReservationStore, ot as UploadTooLarge, p as createFetchUploadTransport, q as ReserveAttachmentOptions, r as RemoteAttachmentStore, rt as InvalidAttachmentRef, s as SwitchboardClientConfig, t as NullAttachmentTransport, tt as AttachmentTransferStage, u as AttachmentUploadRequest, v as parseRef, w as IAttachmentService, x as parseAttachmentUploadTarget, y as AttachmentService, z as AttachmentSendOptions } from "./null-attachment-transport-CMrO_ZKA.js";
+import { A as InvalidAttachmentRef, D as AttachmentTransferStage, E as AttachmentTransferError, M as SizeMismatch, N as UploadTooLarge, O as HashMismatch, S as AttachmentAlreadyExists, T as AttachmentPending, _ as createRef, a as RemoteAttachmentUpload, b as parseAttachmentDownloadTarget, c as XhrUploadTransportOptions, d as AttachmentUploadResponse, f as AttachmentUploadTransport, g as ParsedRef, h as SwitchboardTransportConfig, i as RemoteAttachmentUploadFactory, j as ReservationNotFound, l as createXhrUploadTransport, m as SwitchboardAttachmentTransport, n as createRemoteAttachmentService, o as RemoteReservationStore, p as createFetchUploadTransport, r as RemoteAttachmentStore, s as SwitchboardClientConfig, t as NullAttachmentTransport, u as AttachmentUploadRequest, v as parseRef, w as AttachmentNotFound, x as parseAttachmentUploadTarget, y as AttachmentService } from "./null-attachment-transport-Bs4JpmFx.js";
+import { A as UploadFirstReserveAttachmentOptions, C as AttachmentUploadResult, D as ReserveAttachmentOptions, E as Reservation, O as TransportFetchResult, S as AttachmentTransportConfig, T as HashFirstReserveAttachmentOptions, _ as AttachmentResponse, a as IAttachmentTransport, b as AttachmentStatus, c as IAttachmentUploadFactory, f as AttachmentDownloadOptions, g as AttachmentMetadata, h as AttachmentHeader, i as IAttachmentStore, k as TransportResponse, l as IReservationStore, m as AttachmentDownloadTargetOptions, n as IAttachmentReader, o as IAttachmentTransportFactory, p as AttachmentDownloadTarget, r as IAttachmentService, s as IAttachmentUpload, v as AttachmentSendOptions, w as AttachmentUploadTarget, x as AttachmentTargetHeaders, y as AttachmentStatOptions } from "./interfaces-C4GRlKeB.js";
 import { AttachmentHash, AttachmentRef } from "@powerhousedao/reactor";
-
 //#region src/concurrency.d.ts
 /**
  * Ordered result of one batch item. `index` always mirrors the input
@@ -17,7 +17,8 @@ type BatchItemResult<R> = {
   error: unknown;
 };
 type RunWithConcurrencyOptions<R = unknown> = {
-  /** Maximum simultaneously running workers. Must be a positive integer. */concurrency: number;
+  /** Maximum simultaneously running workers. Must be a positive integer. */
+  concurrency: number;
   /**
    * Whole-batch cancellation: unstarted items are rejected with the signal's
    * reason without ever starting, while already-started items keep running —
@@ -37,7 +38,7 @@ type RunWithConcurrencyOptions<R = unknown> = {
  * executions. Bounding starts (not just transfers) is what keeps memory flat:
  * an item's preprocessing (hashing/buffering) only begins when a slot frees.
  */
-declare function runWithConcurrency<T, R>(items: readonly T[], worker: (item: T, index: number) => Promise<R>, options: RunWithConcurrencyOptions<R>): Promise<BatchItemResult<R>[]>;
+export declare function runWithConcurrency<T, R>(items: readonly T[], worker: (item: T, index: number) => Promise<R>, options: RunWithConcurrencyOptions<R>): Promise<BatchItemResult<R>[]>;
 //#endregion
 //#region src/progress.d.ts
 /**
@@ -50,26 +51,32 @@ declare function runWithConcurrency<T, R>(items: readonly T[], worker: (item: T,
  */
 type AttachmentStage = "hashing" | "reserving" | "uploading" | "requesting-download-target" | "downloading" | "done" | "error";
 type AttachmentProgress = {
-  stage: AttachmentStage; /** Bytes moved so far within `stage`. */
-  loaded: number; /** Denominator for `stage`: file.size for uploads, header.sizeBytes for downloads. */
-  total: number | undefined; /** True when the stage is running but bytes cannot (yet) be observed. */
-  indeterminate: boolean; /** Only on a terminal `done` where dedup skipped the transfer entirely. */
+  stage: AttachmentStage;
+  /** Bytes moved so far within `stage`. */
+  loaded: number;
+  /** Denominator for `stage`: file.size for uploads, header.sizeBytes for downloads. */
+  total: number | undefined;
+  /** True when the stage is running but bytes cannot (yet) be observed. */
+  indeterminate: boolean;
+  /** Only on a terminal `done` where dedup skipped the transfer entirely. */
   deduped?: true;
 };
 type AttachmentProgressListener = (progress: AttachmentProgress) => void;
 type AttachmentProgressOptions = {
-  onProgress?: AttachmentProgressListener; /** Min ms between byte events within a stage. Default 100. 0 emits every observation. */
+  onProgress?: AttachmentProgressListener;
+  /** Min ms between byte events within a stage. Default 100. 0 emits every observation. */
   throttleMs?: number;
 };
-declare const DEFAULT_PROGRESS_THROTTLE_MS = 100;
+export declare const DEFAULT_PROGRESS_THROTTLE_MS = 100;
 /**
  * Fraction in 0..1 for a progress event. Indeterminate and unknown-total
  * events read as 0 — a bar cannot honestly show a position it does not know.
  * A zero total is complete by definition (the dedup case moves no bytes).
  */
-declare function progressFraction(progress: AttachmentProgress): number;
+export declare function progressFraction(progress: AttachmentProgress): number;
 type ProgressEmitterOptions = AttachmentProgressOptions & {
-  /** Injected clock so throttle tests stay synchronous. */now?: () => number;
+  /** Injected clock so throttle tests stay synchronous. */
+  now?: () => number;
 };
 /**
  * Emits `AttachmentProgress` for one single-item operation, upholding:
@@ -86,7 +93,7 @@ type ProgressEmitterOptions = AttachmentProgressOptions & {
  * ordering, and is unnecessary because `finish()` always emits
  * `loaded === total`, making a dropped last intra-stage tick invisible.
  */
-declare class ProgressEmitter {
+export declare class ProgressEmitter {
   private readonly listener;
   private readonly throttleMs;
   private readonly now;
@@ -128,7 +135,9 @@ declare class ProgressEmitter {
   private emit;
 }
 type ByteProgressHooks = {
-  /** Cumulative bytes handed to the consumer. */onBytes?: (loaded: number) => void; /** The source ended and every byte reached the consumer. */
+  /** Cumulative bytes handed to the consumer. */
+  onBytes?: (loaded: number) => void;
+  /** The source ended and every byte reached the consumer. */
   onDone?: () => void;
   onError?: (error: unknown) => void;
 };
@@ -150,21 +159,26 @@ type ByteProgressHooks = {
  * Returns `source` unchanged when no hook is supplied, so a caller with no
  * listener pays nothing.
  */
-declare function withByteProgress(source: ReadableStream<Uint8Array>, hooks: ByteProgressHooks): ReadableStream<Uint8Array>;
+export declare function withByteProgress(source: ReadableStream<Uint8Array>, hooks: ByteProgressHooks): ReadableStream<Uint8Array>;
 //#endregion
 //#region src/client.d.ts
-type PreprocessResult = {
+export type PreprocessResult = {
   ref: AttachmentRef;
   hash: AttachmentHash;
   sizeBytes: number;
   options: HashFirstReserveAttachmentOptions;
+  /** @deprecated Read `blob`; this is `blob.stream()`. */
   data: ReadableStream<Uint8Array>;
+  /** @deprecated Read `blob`; this is `() => blob.stream()`. */
   stream: () => ReadableStream<Uint8Array>;
+  /** The file itself; uploads send it as-is, so a browser streams it from disk. */
+  blob: Blob;
 };
-type AttachmentUploadInput = {
+export type AttachmentUploadInput = {
   file: Blob;
   fileName?: string;
-  mimeType?: string; /** Per-item cancellation, checked between stages. */
+  mimeType?: string;
+  /** Per-item cancellation, checked between stages. */
   signal?: AbortSignal;
 };
 /**
@@ -175,7 +189,7 @@ type AttachmentUploadInput = {
  * upload. Passing the result back in skips the hashing stage rather than
  * faking a zero-millisecond one.
  */
-type AttachmentPreprocessedUploadInput = {
+export type AttachmentPreprocessedUploadInput = {
   preprocessed: PreprocessResult;
   signal?: AbortSignal;
 };
@@ -183,7 +197,7 @@ type AttachmentPreprocessedUploadInput = {
  * Every remote download names the document that authorizes its ref; batches
  * may freely mix documents because the anchor travels with each item.
  */
-type AttachmentDownloadInput = {
+export type AttachmentDownloadInput = {
   documentId: string;
   ref: AttachmentRef;
   signal?: AbortSignal;
@@ -194,25 +208,27 @@ type AttachmentDownloadInput = {
  * blob-producing conveniences let callers override what the server header
  * reports from upload time.
  */
-type AttachmentBlobOptions = {
+export type AttachmentBlobOptions = {
   mimeType?: string;
 };
-type AttachmentSaveOptions = {
+export type AttachmentSaveOptions = {
   fileName?: string;
   mimeType?: string;
 };
-type AttachmentBlobResult = {
+export type AttachmentBlobResult = {
   blob: Blob;
   header: AttachmentHeader;
 };
-type AttachmentObjectUrl = {
-  /** Ready for img/iframe/video src. Pins memory until revoke() is called. */url: string;
+export type AttachmentObjectUrl = {
+  /** Ready for img/iframe/video src. Pins memory until revoke() is called. */
+  url: string;
   header: AttachmentHeader;
   revoke: () => void;
 };
-type AttachmentShareLinkInput = {
+export type AttachmentShareLinkInput = {
   documentId: string;
-  ref: AttachmentRef; /** Requested link lifetime in seconds; the server clamps to its maximum. */
+  ref: AttachmentRef;
+  /** Requested link lifetime in seconds; the server clamps to its maximum. */
   expiresIn?: number;
   signal?: AbortSignal;
 };
@@ -221,7 +237,7 @@ type AttachmentShareLinkInput = {
  * expiresAtUtc, with no login and no document access. Minting one requires
  * document read access; once minted it cannot be revoked before expiry.
  */
-type AttachmentShareLink = {
+export type AttachmentShareLink = {
   url: string;
   expiresAtUtc: string;
 };
@@ -231,8 +247,10 @@ type AttachmentShareLink = {
  * a presentation decision the client cannot make, and a confirmed dedup would
  * shrink the denominator mid-flight.
  */
-type AttachmentBatchOptions = {
-  /** Bounds preprocessing and transfer together. Defaults to 4. */concurrency?: number; /** Whole-batch cancellation: stops unstarted items. */
+export type AttachmentBatchOptions = {
+  /** Bounds preprocessing and transfer together. Defaults to 4. */
+  concurrency?: number;
+  /** Whole-batch cancellation: stops unstarted items. */
   signal?: AbortSignal;
   onProgress?: (progress: AttachmentProgress & {
     index: number;
@@ -241,17 +259,18 @@ type AttachmentBatchOptions = {
    * Fired as each item settles, including items the signal skipped before they
    * started, so `settled` always reaches `total`.
    */
-  onItemSettled?: (counts: AttachmentBatchCounts) => void; /** Min ms between byte events, applied per item rather than batch-wide. */
+  onItemSettled?: (counts: AttachmentBatchCounts) => void;
+  /** Min ms between byte events, applied per item rather than batch-wide. */
   throttleMs?: number;
 };
-type AttachmentBatchCounts = {
+export type AttachmentBatchCounts = {
   settled: number;
   completed: number;
   failed: number;
   total: number;
 };
-declare const DEFAULT_ATTACHMENT_BATCH_CONCURRENCY = 4;
-interface IAttachmentClient {
+export declare const DEFAULT_ATTACHMENT_BATCH_CONCURRENCY = 4;
+export interface IAttachmentClient {
   preprocess(file: Blob, opts?: {
     fileName?: string;
     mimeType?: string;
@@ -303,7 +322,8 @@ interface IAttachmentClient {
   uploadMany(inputs: readonly AttachmentUploadInput[], options?: AttachmentBatchOptions): Promise<BatchItemResult<AttachmentUploadResult>[]>;
   downloadMany(inputs: readonly AttachmentDownloadInput[], options?: AttachmentBatchOptions): Promise<BatchItemResult<AttachmentResponse>[]>;
 }
-declare function createAttachmentClient(service: IAttachmentService): IAttachmentClient;
+export declare function createAttachmentClient(service: IAttachmentService): IAttachmentClient;
 //#endregion
-export { AttachmentAlreadyExists, AttachmentBatchCounts, AttachmentBatchOptions, AttachmentBlobOptions, AttachmentBlobResult, AttachmentDownloadInput, type AttachmentDownloadOptions, type AttachmentDownloadTarget, type AttachmentDownloadTargetOptions, type AttachmentHeader, type AttachmentMetadata, AttachmentNotFound, AttachmentObjectUrl, AttachmentPending, AttachmentPreprocessedUploadInput, type AttachmentProgress, type AttachmentProgressListener, type AttachmentProgressOptions, type AttachmentResponse, AttachmentSaveOptions, type AttachmentSendOptions, AttachmentService, AttachmentShareLink, AttachmentShareLinkInput, type AttachmentStage, type AttachmentStatus, type AttachmentTargetHeaders, AttachmentTransferError, type AttachmentTransferStage, type AttachmentTransportConfig, AttachmentUploadInput, type AttachmentUploadRequest, type AttachmentUploadResponse, type AttachmentUploadResult, type AttachmentUploadTarget, type AttachmentUploadTransport, type BatchItemResult, type ByteProgressHooks, DEFAULT_ATTACHMENT_BATCH_CONCURRENCY, DEFAULT_PROGRESS_THROTTLE_MS, type HashFirstReserveAttachmentOptions, HashMismatch, IAttachmentClient, type IAttachmentReader, type IAttachmentService, type IAttachmentStore, type IAttachmentTransport, type IAttachmentTransportFactory, type IAttachmentUpload, type IAttachmentUploadFactory, type IReservationStore, InvalidAttachmentRef, NullAttachmentTransport, type ParsedRef, PreprocessResult, ProgressEmitter, type ProgressEmitterOptions, RemoteAttachmentStore, RemoteAttachmentUpload, RemoteAttachmentUploadFactory, RemoteReservationStore, type Reservation, ReservationNotFound, type ReserveAttachmentOptions, type RunWithConcurrencyOptions, SizeMismatch, SwitchboardAttachmentTransport, type SwitchboardClientConfig, type SwitchboardTransportConfig, type TransportFetchResult, type TransportResponse, type UploadFirstReserveAttachmentOptions, UploadTooLarge, type XhrUploadTransportOptions, createAttachmentClient, createFetchUploadTransport, createRef, createRemoteAttachmentService, createXhrUploadTransport, parseAttachmentDownloadTarget, parseAttachmentUploadTarget, parseRef, progressFraction, runWithConcurrency, withByteProgress };
+export { AttachmentAlreadyExists, type AttachmentDownloadOptions, type AttachmentDownloadTarget, type AttachmentDownloadTargetOptions, type AttachmentHeader, type AttachmentMetadata, AttachmentNotFound, AttachmentPending, type AttachmentProgress, type AttachmentProgressListener, type AttachmentProgressOptions, type AttachmentResponse, type AttachmentSendOptions, AttachmentService, type AttachmentStage, type AttachmentStatOptions, type AttachmentStatus, type AttachmentTargetHeaders, AttachmentTransferError, type AttachmentTransferStage, type AttachmentTransportConfig, type AttachmentUploadRequest, type AttachmentUploadResponse, type AttachmentUploadResult, type AttachmentUploadTarget, type AttachmentUploadTransport, type BatchItemResult, type ByteProgressHooks, type HashFirstReserveAttachmentOptions, HashMismatch, type IAttachmentReader, type IAttachmentService, type IAttachmentStore, type IAttachmentTransport, type IAttachmentTransportFactory, type IAttachmentUpload, type IAttachmentUploadFactory, type IReservationStore, InvalidAttachmentRef, NullAttachmentTransport, type ParsedRef, type ProgressEmitterOptions, RemoteAttachmentStore, RemoteAttachmentUpload, RemoteAttachmentUploadFactory, RemoteReservationStore, type Reservation, ReservationNotFound, type ReserveAttachmentOptions, type RunWithConcurrencyOptions, SizeMismatch, SwitchboardAttachmentTransport, type SwitchboardClientConfig, type SwitchboardTransportConfig, type TransportFetchResult, type TransportResponse, type UploadFirstReserveAttachmentOptions, UploadTooLarge, type XhrUploadTransportOptions, createFetchUploadTransport, createRef, createRemoteAttachmentService, createXhrUploadTransport, parseAttachmentDownloadTarget, parseAttachmentUploadTarget, parseRef };
+export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../src/concurrency.ts","../src/progress.ts","../src/client.ts"],"mappings":"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"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/concurrency.ts","../src/progress.ts","../src/client.ts"],"mappings":";;;;;;;;;KAKY,gBAAgB;EACtB;EAAe;EAAqB,OAAO;;EAC3C;EAAe;EAAoB;;KAE7B,0BAA0B;;EAEpC;;;;;;EAMA,SAAS;;;;;;;EAOT,aAAa,QAAQ,gBAAgB;;;;;;;wBAQjB,mBAAmB,GAAG,GAC1C,gBAAgB,KAChB,SAAS,MAAM,GAAG,kBAAkB,QAAQ,IAC5C,SAAS,0BAA0B,KAClC,QAAQ,gBAAgB;;;;;;;;;;;KC3Bf;KASA;EACV,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;KAGU,8BAA8B,UAAU;KAExC;EACV,aAAa;;EAEb;;qBAGW;;;;;;wBAOG,iBAAiB,UAAU;KAS/B,yBAAyB;;EAEnC;;;;;;;;;;;;;;;;;qBAkBW;mBACM;mBACA;mBACA;UAET;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,UAAU;;MAOlB;;;;;;EASJ,MAAM,OAAO,iBAAiB;IAAY;;;;;;EAkB1C,MAAM,gBAAgB;;;;;EAoBtB,OAAO;IAAa;IAAiB;IAAgB;;;EAerD;;EAKA;UAWQ;;KAME;;EAEV,WAAW;;EAEX;EACA,WAAW;;;;;;;;;;;;;;;;;;;;wBAqBG,iBACd,QAAQ,eAAe,aACvB,OAAO,oBACN,eAAe;;;YCjGN;EACV,KAAK;EACL,MAAM;EACN;EACA,SAAS;;EAET,MAAM,eAAe;;EAErB,cAAc,eAAe;;EAE7B,MAAM;;YAGI;EACV,MAAM;EACN;EACA;;EAEA,SAAS;;;;;;;;;;YAWC;EACV,cAAc;EACd,SAAS;;;;;;YAOC;EACV;EACA,KAAK;EACL,SAAS;;;;;;;;YASC;EACV;;YAGU;EACV;EACA;;YAGU;EACV,MAAM;EACN,QAAQ;;YAGE;;EAEV;EACA,QAAQ;EACR;;YAGU;EACV;EACA,KAAK;;EAEL;EACA,SAAS;;;;;;;YAQC;EACV;EACA;;;;;;;;YASU;;EAEV;;EAEA,SAAS;EACT,cAAc,UAAU;IAAuB;;;;;;EAK/C,iBAAiB,QAAQ;;EAEzB;;YAGU;EACV;EACA;EACA;EACA;;qBAGW;iBAEI;EACf,WACE,MAAM,MACN;IAAS;IAAmB;MAC3B,QAAQ;EACX,QACE,SAAS,mCACT,OAAO,QAAQ,sBAAsB,QAAQ,0BAC5C,QAAQ;;;;;;;;EAQX,OACE,OAAO,wBAAwB,mCAC/B,UAAU,4BACT,QAAQ;;;;;;;;;EASX,SACE,OAAO,yBACP,UAAU,4BACT,QAAQ;;;;;;EAMX,aACE,OAAO,yBACP,UAAU,wBAAwB,4BACjC,QAAQ;;;;;;EAMX,eACE,OAAO,yBACP,UAAU,wBAAwB,4BACjC;;;;;;EAMH,kBACE,OAAO,yBACP,UAAU,wBAAwB,4BACjC,QAAQ;;;;;;;;EAQX,aAAa,OAAO,2BAA2B,QAAQ;EACvD,WACE,iBAAiB,yBACjB,UAAU,yBACT,QAAQ,gBAAgB;EAC3B,aACE,iBAAiB,2BACjB,UAAU,yBACT,QAAQ,gBAAgB;;wBA6Xb,uBACd,SAAS,qBACR"}