@fluidgrids/workflows 2026.1028.2 → 2026.1030.1

package/dist/chunk-VU5S5A7V.js

@@ -0,0 +1,150 @@
+// src/history/payload-fields.ts
+var ENCODED_PAYLOAD_MARKER = "$fgp";
+var ENCODED_PAYLOAD_VERSION = 1;
+var PAYLOAD_ENCODINGS = [
+  "json/plain",
+  "binary/plain",
+  "binary/encrypted",
+  "kms/envelope"
+];
+var ENCODED_KEYS = /* @__PURE__ */ new Set(["$fgp", "encoding", "metadata", "data"]);
+var BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
+function isEncodedPayload(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  const record = value;
+  if (record[ENCODED_PAYLOAD_MARKER] !== ENCODED_PAYLOAD_VERSION) return false;
+  if (!Object.keys(record).every((key) => ENCODED_KEYS.has(key))) return false;
+  const encoding = record["encoding"];
+  if (typeof encoding !== "string" || encoding === "" || encoding === "json/plain") return false;
+  const data = record["data"];
+  if (typeof data !== "string" || data.length % 4 !== 0 || !BASE64.test(data)) return false;
+  const metadata = record["metadata"];
+  if (metadata === void 0) return true;
+  if (typeof metadata !== "object" || metadata === null || Array.isArray(metadata)) return false;
+  return Object.values(metadata).every((entry) => typeof entry === "string");
+}
+function payloadEncodingOf(value) {
+  return isEncodedPayload(value) ? value.encoding : "json/plain";
+}
+var PAYLOAD_FIELDS = {
+  WORKFLOW_STARTED: ["/input", "/lastCompletionResult", "/context"],
+  ACTIVITY_SCHEDULED: ["/args"],
+  ACTIVITY_HEARTBEAT: ["/details"],
+  ACTIVITY_COMPLETED: ["/result"],
+  ACTIVITY_CANCELLED: ["/details"],
+  SIGNAL_RECEIVED: ["/payload"],
+  UPDATE_ADMITTED: ["/args"],
+  UPDATE_ACCEPTED: ["/args"],
+  UPDATE_COMPLETED: ["/result"],
+  CHILD_RUN_INITIATED: ["/input", "/options/context"],
+  CHILD_RUN_COMPLETED: ["/result"],
+  EXTERNAL_RUN_SIGNALED: ["/payload"],
+  SIDE_EFFECT_RECORDED: ["/value"],
+  LOCAL_ACTIVITY_COMPLETED: ["/result"],
+  CONTEXT_UPSERTED: ["/entries"],
+  MARKER_RECORDED: ["/data/currentDetails"],
+  WORKFLOW_COMPLETED: ["/output"],
+  WORKFLOW_CANCELLED: ["/details"],
+  WORKFLOW_CONTINUED_AS_NEW: ["/input", "/options/context"]
+};
+var FAILURE_FIELDS = {
+  WORKFLOW_STARTED: ["/lastFailure"],
+  ACTIVITY_FAILED: ["/failure"],
+  ACTIVITY_TIMED_OUT: ["/failure"],
+  UPDATE_COMPLETED: ["/failure"],
+  CHILD_RUN_FAILED: ["/failure"],
+  EXTERNAL_RUN_SIGNALED: ["/failure"],
+  EXTERNAL_RUN_CANCEL_RESOLVED: ["/failure"],
+  LOCAL_ACTIVITY_FAILED: ["/failure"],
+  WORKFLOW_FAILED: ["/failure"],
+  WORKFLOW_TIMED_OUT: ["/failure"]
+};
+var COMMAND_PAYLOAD_FIELDS = {
+  SCHEDULE_ACTIVITY: ["/args"],
+  START_CHILD_RUN: ["/input", "/options/context"],
+  SIGNAL_RUN: ["/payload"],
+  RECORD_SIDE_EFFECT: ["/value"],
+  RECORD_MARKER: ["/data/currentDetails"],
+  COMPLETE_WORKFLOW: ["/output"],
+  UPSERT_CONTEXT: ["/entries"],
+  RECORD_LOCAL_ACTIVITY: ["/result"],
+  CONTINUE_AS_NEW: ["/input", "/options/context"],
+  COMPLETE_UPDATE: ["/result"]
+};
+var COMMAND_FAILURE_FIELDS = {
+  FAIL_WORKFLOW: ["/failure"],
+  RECORD_LOCAL_ACTIVITY: ["/failure"],
+  REJECT_UPDATE: ["/failure"],
+  COMPLETE_UPDATE: ["/failure"]
+};
+var FAILURE_PAYLOAD_FIELDS = ["/details"];
+var FAILURE_CAUSE_FIELD = "/cause";
+var PAYLOAD_FIELDS_FORMAT = "fluidgrids.payload-fields";
+var PAYLOAD_FIELDS_DOCUMENT = {
+  format: PAYLOAD_FIELDS_FORMAT,
+  formatVersion: 2,
+  description: 'JSON pointers of user payloads per event type (relative to the payload) and per command type (relative to the command). `events` and `commands` are plain payload pointers. `eventFailures` and `commandFailures` point at failure objects: the payloads of a failure are the `failure.payloads` pointers relative to it, and the same rule applies again to the failure at `failure.cause` (recursively, to the end of the cause chain). Payload codecs and the at-rest envelope apply to these pointers only; everything else stays in clear text. A value that is not plain JSON is carried as {"$fgp": 1, "encoding", "metadata"?, "data" (base64)}.',
+  encodedMarker: ENCODED_PAYLOAD_MARKER,
+  encodedVersion: ENCODED_PAYLOAD_VERSION,
+  encodings: [...PAYLOAD_ENCODINGS],
+  events: PAYLOAD_FIELDS,
+  commands: COMMAND_PAYLOAD_FIELDS,
+  eventFailures: FAILURE_FIELDS,
+  commandFailures: COMMAND_FAILURE_FIELDS,
+  failure: { payloads: FAILURE_PAYLOAD_FIELDS, cause: FAILURE_CAUSE_FIELD }
+};
+function tokensOf(pointer) {
+  if (pointer === "") return [];
+  return pointer.slice(1).split("/").map((token) => token.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+function locate(root, pointer) {
+  const tokens = tokensOf(pointer);
+  const key = tokens.pop();
+  if (key === void 0) return void 0;
+  let holder = root;
+  for (const token of tokens) {
+    if (typeof holder !== "object" || holder === null || Array.isArray(holder)) return void 0;
+    holder = holder[token];
+  }
+  if (typeof holder !== "object" || holder === null || Array.isArray(holder)) return void 0;
+  const parent = holder;
+  if (!Object.hasOwn(parent, key) || parent[key] === void 0) return void 0;
+  return { parent, key };
+}
+function mapAt(root, pointer, fn) {
+  const found = locate(root, pointer);
+  if (found === void 0) return;
+  const current = found.parent[found.key];
+  if (current !== void 0) found.parent[found.key] = fn(current, pointer);
+}
+function mapFailureAt(root, pointer, fn) {
+  let failure = pointer;
+  for (; ; ) {
+    const found = locate(root, failure);
+    if (found === void 0) return;
+    const value = found.parent[found.key];
+    if (typeof value !== "object" || value === null || Array.isArray(value)) return;
+    for (const field of FAILURE_PAYLOAD_FIELDS) mapAt(root, failure + field, fn);
+    failure += FAILURE_CAUSE_FIELD;
+  }
+}
+function mapPayloadFields(record, pointers, fn, failures = []) {
+  const copy = JSON.parse(JSON.stringify(record));
+  for (const pointer of pointers) mapAt(copy, pointer, fn);
+  for (const pointer of failures) mapFailureAt(copy, pointer, fn);
+  return copy;
+}
+function mapEventPayloads(type, payload, fn) {
+  return mapPayloadFields(payload, PAYLOAD_FIELDS[type] ?? [], fn, FAILURE_FIELDS[type] ?? []);
+}
+function mapCommandPayloads(command, fn) {
+  const record = command;
+  return mapPayloadFields(
+    record,
+    COMMAND_PAYLOAD_FIELDS[command.type] ?? [],
+    fn,
+    COMMAND_FAILURE_FIELDS[command.type] ?? []
+  );
+}
+
+export { COMMAND_FAILURE_FIELDS, COMMAND_PAYLOAD_FIELDS, ENCODED_PAYLOAD_MARKER, ENCODED_PAYLOAD_VERSION, FAILURE_CAUSE_FIELD, FAILURE_FIELDS, FAILURE_PAYLOAD_FIELDS, PAYLOAD_ENCODINGS, PAYLOAD_FIELDS, PAYLOAD_FIELDS_DOCUMENT, PAYLOAD_FIELDS_FORMAT, isEncodedPayload, mapCommandPayloads, mapEventPayloads, mapPayloadFields, payloadEncodingOf };