@feedclip/activity 0.1.0

package/dist/index.js

@@ -0,0 +1,228 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/activity.ts
+var ActivityError = class extends Error {
+  constructor(code, message, field) {
+    super(message);
+    __publicField(this, "code");
+    __publicField(this, "field");
+    this.name = "ActivityError";
+    this.code = code;
+    this.field = field;
+  }
+};
+function createActivity({
+  adapter,
+  clock = () => /* @__PURE__ */ new Date(),
+  idGenerator = createId
+}) {
+  return {
+    async track(input) {
+      const record = createRecord(input, clock, idGenerator);
+      await adapter.insert(record);
+      return record;
+    },
+    async query(options) {
+      const normalized = normalizeQuery(options);
+      const result = await adapter.query(normalized);
+      return result.entries;
+    }
+  };
+}
+function createMemoryStorageAdapter(initialEntries = [], latency = 0) {
+  let entries = initialEntries.map(freezeRecord);
+  return {
+    async insert(entry) {
+      await wait(latency);
+      entries = [freezeRecord(entry), ...entries];
+    },
+    async query(options) {
+      await wait(latency);
+      const normalized = normalizeQuery(options);
+      const filtered = entries.filter((entry) => entry.resource.type === normalized.resource.type).filter((entry) => entry.resource.id === normalized.resource.id).filter((entry) => matchesActions(entry, normalized.actions)).filter((entry) => matchesActor(entry, normalized.actorId ?? normalized.actor)).filter((entry) => matchesDates(entry, normalized.from, normalized.to)).filter((entry) => matchesSearch(entry, normalized.search)).sort(compareRecords);
+      const offset = normalized.offset ?? 0;
+      const limit = normalized.limit ?? 50;
+      const page = filtered.slice(offset, offset + limit);
+      return {
+        entries: page,
+        total: filtered.length,
+        hasMore: offset + page.length < filtered.length
+      };
+    }
+  };
+}
+function createRecord(input, clock, idGenerator) {
+  validateTrackInput(input);
+  const record = {
+    id: idGenerator(),
+    resource: freezeObject({
+      type: input.resource.type.trim(),
+      id: input.resource.id.trim(),
+      title: input.resource.title?.trim()
+    }),
+    action: input.action.trim().toLowerCase(),
+    actor: freezeObject({ ...input.actor, name: input.actor.name.trim() }),
+    timestamp: input.timestamp ? new Date(input.timestamp) : clock(),
+    changes: input.changes?.map(normalizeChange).map(freezeObject),
+    content: input.content ? freezeObject(input.content) : void 0,
+    metadata: input.metadata ? freezeObject(input.metadata) : void 0
+  };
+  return freezeRecord(record);
+}
+function validateTrackInput(input) {
+  if (!input.resource?.type?.trim()) {
+    throw new ActivityError("INVALID_RESOURCE", "resource.type is required", "resource.type");
+  }
+  if (!input.resource?.id?.trim()) {
+    throw new ActivityError("INVALID_RESOURCE", "resource.id is required", "resource.id");
+  }
+  if (!["user", "system", "api", "agent"].includes(input.actor?.type)) {
+    throw new ActivityError("INVALID_ACTOR", "actor.type is invalid", "actor.type");
+  }
+  if (!input.actor?.id?.trim()) {
+    throw new ActivityError("INVALID_ACTOR", "actor.id is required", "actor.id");
+  }
+  if (!input.actor?.name?.trim()) {
+    throw new ActivityError("INVALID_ACTOR", "actor.name is required", "actor.name");
+  }
+  if (!input.action?.trim()) {
+    throw new ActivityError("INVALID_ACTION", "action is required", "action");
+  }
+  if (input.timestamp && Number.isNaN(input.timestamp.getTime())) {
+    throw new ActivityError("INVALID_TIMESTAMP", "timestamp must be a valid Date", "timestamp");
+  }
+  if (input.action === "update" && !input.changes?.length) {
+    throw new ActivityError("INVALID_ACTION", "update requires at least one change", "changes");
+  }
+  if ((input.action === "comment" || input.action === "attachment") && !input.content) {
+    throw new ActivityError("INVALID_ACTION", `${input.action} requires content`, "content");
+  }
+}
+function normalizeChange(change) {
+  if (!change.field.trim()) {
+    throw new ActivityError("INVALID_CHANGE", "change.field is required", "changes.field");
+  }
+  if (!change.label.trim()) {
+    throw new ActivityError("INVALID_CHANGE", "change.label is required", "changes.label");
+  }
+  return {
+    ...change,
+    field: change.field.trim(),
+    label: change.label.trim(),
+    valueType: change.valueType ?? inferValueType(change.after ?? change.before)
+  };
+}
+function normalizeQuery(options) {
+  if (!options.resource?.type?.trim() || !options.resource?.id?.trim()) {
+    throw new ActivityError("INVALID_RESOURCE", "query.resource is required", "resource");
+  }
+  if (options.limit !== void 0 && (options.limit < 1 || options.limit > 500)) {
+    throw new ActivityError("INVALID_LIMIT", "limit must be between 1 and 500", "limit");
+  }
+  if (options.offset !== void 0 && options.offset < 0) {
+    throw new ActivityError("INVALID_OFFSET", "offset must not be negative", "offset");
+  }
+  if (options.from && options.to && options.from > options.to) {
+    throw new ActivityError("INVALID_DATE_RANGE", "from must be before to", "from");
+  }
+  return freezeObject({
+    ...options,
+    resource: freezeObject({
+      type: options.resource.type.trim(),
+      id: options.resource.id.trim(),
+      title: options.resource.title?.trim()
+    }),
+    search: options.search?.trim() || void 0,
+    actor: options.actor?.trim() || void 0,
+    actorId: options.actorId?.trim() || void 0,
+    actions: options.actions ? Object.freeze(
+      Array.from(
+        new Set(options.actions.map((action) => action.trim().toLowerCase()))
+      )
+    ) : void 0,
+    limit: options.limit ?? 50,
+    offset: options.offset ?? 0
+  });
+}
+function matchesActions(entry, actions) {
+  return !actions?.length || actions.includes(entry.action);
+}
+function matchesActor(entry, actorId) {
+  return !actorId || entry.actor.id === actorId;
+}
+function matchesDates(entry, from, to) {
+  return (!from || entry.timestamp >= from) && (!to || entry.timestamp <= to);
+}
+function matchesSearch(entry, search) {
+  if (!search) {
+    return true;
+  }
+  return searchableText(entry).toLowerCase().includes(search.toLowerCase());
+}
+function searchableText(entry) {
+  return [
+    entry.action,
+    entry.resource.title,
+    entry.actor.name,
+    entry.content ? JSON.stringify(entry.content) : "",
+    ...(entry.changes ?? []).flatMap((change) => [
+      change.field,
+      change.label,
+      stringifyValue(change.before),
+      stringifyValue(change.after)
+    ])
+  ].join(" ");
+}
+function compareRecords(a, b) {
+  const time = b.timestamp.getTime() - a.timestamp.getTime();
+  return time || b.id.localeCompare(a.id);
+}
+function inferValueType(value) {
+  if (value instanceof Date) {
+    return "date";
+  }
+  const valueType = typeof value;
+  if (valueType === "string" || valueType === "number" || valueType === "boolean") {
+    return valueType;
+  }
+  return "json";
+}
+function freezeRecord(record) {
+  return freezeObject({
+    ...record,
+    resource: freezeObject(record.resource),
+    actor: freezeObject(record.actor),
+    changes: record.changes?.map((change) => freezeObject(change)),
+    content: record.content ? freezeObject(record.content) : void 0,
+    metadata: record.metadata ? freezeObject(record.metadata) : void 0
+  });
+}
+function freezeObject(value) {
+  return Object.freeze(value);
+}
+function stringifyValue(value) {
+  if (value === null || value === void 0) {
+    return "";
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function createId() {
+  if (globalThis.crypto?.randomUUID) {
+    return globalThis.crypto.randomUUID();
+  }
+  return `act_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`;
+}
+function wait(ms) {
+  return new Promise((resolve) => globalThis.setTimeout(resolve, ms));
+}
+export {
+  ActivityError,
+  createActivity,
+  createMemoryStorageAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/activity.ts"],
+  "sourcesContent": ["export type ActorType = \"user\" | \"system\" | \"api\" | \"agent\";\n\nexport type BuiltInAction =\n  | \"create\"\n  | \"update\"\n  | \"delete\"\n  | \"archive\"\n  | \"restore\"\n  | \"comment\"\n  | \"attachment\";\n\nexport type Action = BuiltInAction | (string & {});\n\nexport type ValueType =\n  | \"string\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"currency\"\n  | \"user\"\n  | \"enum\"\n  | \"json\"\n  | \"custom\";\n\nexport type Resource = {\n  type: string;\n  id: string;\n  title?: string;\n};\n\nexport type ResourceReference = Pick<Resource, \"type\" | \"id\"> & {\n  title?: string;\n};\n\nexport type Actor = {\n  type: ActorType;\n  id: string;\n  name: string;\n  avatarUrl?: string;\n};\n\nexport type Change = {\n  field: string;\n  label: string;\n  before?: unknown;\n  after?: unknown;\n  valueType: ValueType;\n};\n\nexport type CommentContent = {\n  type: \"comment\";\n  text: string;\n};\n\nexport type AttachmentContent = {\n  type: \"attachment\";\n  fileName: string;\n  mimeType: string;\n  size: number;\n  url?: string;\n};\n\nexport type CustomContent = {\n  type: \"custom\";\n  [key: string]: unknown;\n};\n\nexport type Content = CommentContent | AttachmentContent | CustomContent;\n\nexport type Metadata = {\n  source?: string;\n  version?: string;\n  requestId?: string;\n  ipAddress?: string;\n  custom?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nexport type ActivityRecord = Readonly<{\n  id: string;\n  resource: Readonly<Resource>;\n  action: Action;\n  actor: Readonly<Actor>;\n  timestamp: Date;\n  changes?: readonly Readonly<Change>[];\n  content?: Readonly<Content>;\n  metadata?: Readonly<Metadata>;\n}>;\n\nexport type TrackInput = {\n  resource: ResourceReference;\n  actor: Actor;\n  action: Action;\n  changes?: Change[];\n  content?: Content;\n  metadata?: Metadata;\n  timestamp?: Date;\n};\n\nexport type QueryOptions = {\n  resource: ResourceReference;\n  search?: string;\n  actor?: string;\n  actorId?: string;\n  actions?: readonly Action[];\n  from?: Date;\n  to?: Date;\n  limit?: number;\n  offset?: number;\n};\n\nexport type QueryResult = {\n  entries: ActivityRecord[];\n  total: number;\n  hasMore: boolean;\n};\n\nexport type StorageAdapter = {\n  insert(entry: ActivityRecord): Promise<void>;\n  query(options: QueryOptions): Promise<QueryResult>;\n};\n\nexport type Activity = {\n  track(input: TrackInput): Promise<ActivityRecord>;\n  query(options: QueryOptions): Promise<ActivityRecord[]>;\n};\n\nexport type ActivityOptions = {\n  adapter: StorageAdapter;\n  clock?: () => Date;\n  idGenerator?: () => string;\n};\n\nexport class ActivityError extends Error {\n  readonly code: string;\n  readonly field?: string;\n\n  constructor(code: string, message: string, field?: string) {\n    super(message);\n    this.name = \"ActivityError\";\n    this.code = code;\n    this.field = field;\n  }\n}\n\nexport function createActivity({\n  adapter,\n  clock = () => new Date(),\n  idGenerator = createId,\n}: ActivityOptions): Activity {\n  return {\n    async track(input) {\n      const record = createRecord(input, clock, idGenerator);\n      await adapter.insert(record);\n      return record;\n    },\n    async query(options) {\n      const normalized = normalizeQuery(options);\n      const result = await adapter.query(normalized);\n      return result.entries;\n    },\n  };\n}\n\nexport function createMemoryStorageAdapter(\n  initialEntries: ActivityRecord[] = [],\n  latency = 0,\n): StorageAdapter {\n  let entries = initialEntries.map(freezeRecord);\n\n  return {\n    async insert(entry) {\n      await wait(latency);\n      entries = [freezeRecord(entry), ...entries];\n    },\n    async query(options) {\n      await wait(latency);\n      const normalized = normalizeQuery(options);\n      const filtered = entries\n        .filter((entry) => entry.resource.type === normalized.resource.type)\n        .filter((entry) => entry.resource.id === normalized.resource.id)\n        .filter((entry) => matchesActions(entry, normalized.actions))\n        .filter((entry) => matchesActor(entry, normalized.actorId ?? normalized.actor))\n        .filter((entry) => matchesDates(entry, normalized.from, normalized.to))\n        .filter((entry) => matchesSearch(entry, normalized.search))\n        .sort(compareRecords);\n      const offset = normalized.offset ?? 0;\n      const limit = normalized.limit ?? 50;\n      const page = filtered.slice(offset, offset + limit);\n\n      return {\n        entries: page,\n        total: filtered.length,\n        hasMore: offset + page.length < filtered.length,\n      };\n    },\n  };\n}\n\ntype Queryable = {\n  query(sql: string, params?: readonly unknown[]): Promise<{ rows: unknown[] }>;\n};\n\ntype ReleasableQueryable = Queryable & { release(): void };\ntype Connectable = Queryable & { connect(): Promise<ReleasableQueryable> };\n\nexport function postgresAdapter(client: Queryable | Connectable): StorageAdapter {\n  return {\n    async insert(entry) {\n      const connection = \"connect\" in client ? await client.connect() : client;\n      await connection.query(\"BEGIN\");\n      try {\n        await connection.query(\n          `insert into activity_entries (\n            id, resource_type, resource_id, resource_title, action,\n            actor_type, actor_id, actor_name, actor_avatar_url,\n            content_type, content_json, metadata_json, created_at\n          ) values ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)`,\n          [\n            entry.id,\n            entry.resource.type,\n            entry.resource.id,\n            entry.resource.title ?? null,\n            entry.action,\n            entry.actor.type,\n            entry.actor.id,\n            entry.actor.name,\n            entry.actor.avatarUrl ?? null,\n            entry.content?.type ?? null,\n            entry.content ? JSON.stringify(entry.content) : null,\n            entry.metadata ? JSON.stringify(entry.metadata) : null,\n            entry.timestamp.toISOString(),\n          ],\n        );\n\n        for (const [position, change] of (entry.changes ?? []).entries()) {\n          await connection.query(\n            `insert into activity_changes (\n              id, entry_id, position, field, label, before_value, after_value, value_type\n            ) values ($1, $2, $3, $4, $5, $6, $7, $8)`,\n            [\n              createId(),\n              entry.id,\n              position,\n              change.field,\n              change.label,\n              JSON.stringify(change.before ?? null),\n              JSON.stringify(change.after ?? null),\n              change.valueType,\n            ],\n          );\n        }\n\n        await connection.query(\"COMMIT\");\n      } catch (error) {\n        await connection.query(\"ROLLBACK\");\n        throw toActivityError(error, \"STORAGE_FAILURE\", \"Could not insert activity record\");\n      } finally {\n        if (\"release\" in connection && typeof connection.release === \"function\") {\n          connection.release();\n        }\n      }\n    },\n    async query(options) {\n      const normalized = normalizeQuery(options);\n      const limit = normalized.limit ?? 50;\n      const offset = normalized.offset ?? 0;\n      const params: unknown[] = [normalized.resource.type, normalized.resource.id];\n      const where = [\"e.resource_type = $1\", \"e.resource_id = $2\"];\n\n      if (normalized.actions?.length) {\n        params.push(normalized.actions);\n        where.push(`e.action = any($${params.length}::text[])`);\n      }\n\n      const actorId = normalized.actorId ?? normalized.actor;\n      if (actorId) {\n        params.push(actorId);\n        where.push(`e.actor_id = $${params.length}`);\n      }\n\n      if (normalized.from) {\n        params.push(normalized.from.toISOString());\n        where.push(`e.created_at >= $${params.length}`);\n      }\n\n      if (normalized.to) {\n        params.push(normalized.to.toISOString());\n        where.push(`e.created_at <= $${params.length}`);\n      }\n\n      if (normalized.search) {\n        params.push(`%${normalized.search}%`);\n        const index = params.length;\n        where.push(`(\n          e.actor_name ilike $${index}\n          or e.resource_title ilike $${index}\n          or e.content_json::text ilike $${index}\n          or exists (\n            select 1 from activity_changes c\n            where c.entry_id = e.id\n              and (\n                c.label ilike $${index}\n                or c.before_value::text ilike $${index}\n                or c.after_value::text ilike $${index}\n              )\n          )\n        )`);\n      }\n\n      const whereSql = where.join(\" and \");\n      const count = await client.query(\n        `select count(*)::int as total from activity_entries e where ${whereSql}`,\n        params,\n      );\n      params.push(limit + 1, offset);\n      const rows = await client.query(\n        `select\n          e.*,\n          coalesce(\n            json_agg(\n              json_build_object(\n                'field', c.field,\n                'label', c.label,\n                'before', c.before_value,\n                'after', c.after_value,\n                'valueType', c.value_type\n              )\n              order by c.position\n            ) filter (where c.id is not null),\n            '[]'\n          ) as changes\n        from activity_entries e\n        left join activity_changes c on c.entry_id = e.id\n        where ${whereSql}\n        group by e.id\n        order by e.created_at desc, e.id desc\n        limit $${params.length - 1} offset $${params.length}`,\n        params,\n      );\n\n      const total = readTotal(count.rows[0]);\n      const entries = rows.rows.slice(0, limit).map(mapPostgresRecord);\n\n      return {\n        entries,\n        total,\n        hasMore: rows.rows.length > limit,\n      };\n    },\n  };\n}\n\nfunction createRecord(\n  input: TrackInput,\n  clock: () => Date,\n  idGenerator: () => string,\n): ActivityRecord {\n  validateTrackInput(input);\n\n  const record: ActivityRecord = {\n    id: idGenerator(),\n    resource: freezeObject({\n      type: input.resource.type.trim(),\n      id: input.resource.id.trim(),\n      title: input.resource.title?.trim(),\n    }),\n    action: input.action.trim().toLowerCase() as Action,\n    actor: freezeObject({ ...input.actor, name: input.actor.name.trim() }),\n    timestamp: input.timestamp ? new Date(input.timestamp) : clock(),\n    changes: input.changes?.map(normalizeChange).map(freezeObject),\n    content: input.content ? freezeObject(input.content) : undefined,\n    metadata: input.metadata ? freezeObject(input.metadata) : undefined,\n  };\n\n  return freezeRecord(record);\n}\n\nfunction validateTrackInput(input: TrackInput) {\n  if (!input.resource?.type?.trim()) {\n    throw new ActivityError(\"INVALID_RESOURCE\", \"resource.type is required\", \"resource.type\");\n  }\n\n  if (!input.resource?.id?.trim()) {\n    throw new ActivityError(\"INVALID_RESOURCE\", \"resource.id is required\", \"resource.id\");\n  }\n\n  if (![\"user\", \"system\", \"api\", \"agent\"].includes(input.actor?.type)) {\n    throw new ActivityError(\"INVALID_ACTOR\", \"actor.type is invalid\", \"actor.type\");\n  }\n\n  if (!input.actor?.id?.trim()) {\n    throw new ActivityError(\"INVALID_ACTOR\", \"actor.id is required\", \"actor.id\");\n  }\n\n  if (!input.actor?.name?.trim()) {\n    throw new ActivityError(\"INVALID_ACTOR\", \"actor.name is required\", \"actor.name\");\n  }\n\n  if (!input.action?.trim()) {\n    throw new ActivityError(\"INVALID_ACTION\", \"action is required\", \"action\");\n  }\n\n  if (input.timestamp && Number.isNaN(input.timestamp.getTime())) {\n    throw new ActivityError(\"INVALID_TIMESTAMP\", \"timestamp must be a valid Date\", \"timestamp\");\n  }\n\n  if (input.action === \"update\" && !input.changes?.length) {\n    throw new ActivityError(\"INVALID_ACTION\", \"update requires at least one change\", \"changes\");\n  }\n\n  if ((input.action === \"comment\" || input.action === \"attachment\") && !input.content) {\n    throw new ActivityError(\"INVALID_ACTION\", `${input.action} requires content`, \"content\");\n  }\n}\n\nfunction normalizeChange(change: Change): Change {\n  if (!change.field.trim()) {\n    throw new ActivityError(\"INVALID_CHANGE\", \"change.field is required\", \"changes.field\");\n  }\n\n  if (!change.label.trim()) {\n    throw new ActivityError(\"INVALID_CHANGE\", \"change.label is required\", \"changes.label\");\n  }\n\n  return {\n    ...change,\n    field: change.field.trim(),\n    label: change.label.trim(),\n    valueType: change.valueType ?? inferValueType(change.after ?? change.before),\n  };\n}\n\nfunction normalizeQuery(options: QueryOptions): QueryOptions {\n  if (!options.resource?.type?.trim() || !options.resource?.id?.trim()) {\n    throw new ActivityError(\"INVALID_RESOURCE\", \"query.resource is required\", \"resource\");\n  }\n\n  if (options.limit !== undefined && (options.limit < 1 || options.limit > 500)) {\n    throw new ActivityError(\"INVALID_LIMIT\", \"limit must be between 1 and 500\", \"limit\");\n  }\n\n  if (options.offset !== undefined && options.offset < 0) {\n    throw new ActivityError(\"INVALID_OFFSET\", \"offset must not be negative\", \"offset\");\n  }\n\n  if (options.from && options.to && options.from > options.to) {\n    throw new ActivityError(\"INVALID_DATE_RANGE\", \"from must be before to\", \"from\");\n  }\n\n  return freezeObject({\n    ...options,\n    resource: freezeObject({\n      type: options.resource.type.trim(),\n      id: options.resource.id.trim(),\n      title: options.resource.title?.trim(),\n    }),\n    search: options.search?.trim() || undefined,\n    actor: options.actor?.trim() || undefined,\n    actorId: options.actorId?.trim() || undefined,\n    actions: options.actions\n      ? Object.freeze(\n          Array.from(\n            new Set(options.actions.map((action) => action.trim().toLowerCase() as Action)),\n          ),\n        )\n      : undefined,\n    limit: options.limit ?? 50,\n    offset: options.offset ?? 0,\n  });\n}\n\nfunction matchesActions(entry: ActivityRecord, actions?: readonly Action[]) {\n  return !actions?.length || actions.includes(entry.action);\n}\n\nfunction matchesActor(entry: ActivityRecord, actorId?: string) {\n  return !actorId || entry.actor.id === actorId;\n}\n\nfunction matchesDates(entry: ActivityRecord, from?: Date, to?: Date) {\n  return (!from || entry.timestamp >= from) && (!to || entry.timestamp <= to);\n}\n\nfunction matchesSearch(entry: ActivityRecord, search?: string) {\n  if (!search) {\n    return true;\n  }\n\n  return searchableText(entry).toLowerCase().includes(search.toLowerCase());\n}\n\nfunction searchableText(entry: ActivityRecord) {\n  return [\n    entry.action,\n    entry.resource.title,\n    entry.actor.name,\n    entry.content ? JSON.stringify(entry.content) : \"\",\n    ...(entry.changes ?? []).flatMap((change) => [\n      change.field,\n      change.label,\n      stringifyValue(change.before),\n      stringifyValue(change.after),\n    ]),\n  ].join(\" \");\n}\n\nfunction compareRecords(a: ActivityRecord, b: ActivityRecord) {\n  const time = b.timestamp.getTime() - a.timestamp.getTime();\n  return time || b.id.localeCompare(a.id);\n}\n\nfunction inferValueType(value: unknown): ValueType {\n  if (value instanceof Date) {\n    return \"date\";\n  }\n\n  const valueType = typeof value;\n  if (valueType === \"string\" || valueType === \"number\" || valueType === \"boolean\") {\n    return valueType;\n  }\n\n  return \"json\";\n}\n\nfunction freezeRecord(record: ActivityRecord): ActivityRecord {\n  return freezeObject({\n    ...record,\n    resource: freezeObject(record.resource),\n    actor: freezeObject(record.actor),\n    changes: record.changes?.map((change) => freezeObject(change)),\n    content: record.content ? freezeObject(record.content) : undefined,\n    metadata: record.metadata ? freezeObject(record.metadata) : undefined,\n  });\n}\n\nfunction freezeObject<T extends object>(value: T): Readonly<T> {\n  return Object.freeze(value);\n}\n\nfunction stringifyValue(value: unknown) {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n\n  return typeof value === \"string\" ? value : JSON.stringify(value);\n}\n\nfunction createId() {\n  if (globalThis.crypto?.randomUUID) {\n    return globalThis.crypto.randomUUID();\n  }\n\n  return `act_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`;\n}\n\nfunction wait(ms: number) {\n  return new Promise((resolve) => globalThis.setTimeout(resolve, ms));\n}\n\nfunction readTotal(row: unknown) {\n  if (isRecord(row) && typeof row.total === \"number\") {\n    return row.total;\n  }\n\n  if (isRecord(row) && typeof row.total === \"string\") {\n    return Number(row.total);\n  }\n\n  return 0;\n}\n\nfunction mapPostgresRecord(row: unknown): ActivityRecord {\n  if (!isRecord(row)) {\n    throw new ActivityError(\"STORAGE_FAILURE\", \"Invalid activity row returned by storage\");\n  }\n\n  return freezeRecord({\n    id: String(row.id),\n    resource: {\n      type: String(row.resource_type),\n      id: String(row.resource_id),\n      title: typeof row.resource_title === \"string\" ? row.resource_title : undefined,\n    },\n    action: String(row.action) as Action,\n    actor: {\n      type: String(row.actor_type) as ActorType,\n      id: String(row.actor_id),\n      name: String(row.actor_name),\n      avatarUrl: typeof row.actor_avatar_url === \"string\" ? row.actor_avatar_url : undefined,\n    },\n    timestamp: new Date(String(row.created_at)),\n    changes: Array.isArray(row.changes) ? row.changes.map(mapPostgresChange) : undefined,\n    content: isContent(row.content_json) ? row.content_json : undefined,\n    metadata: isRecord(row.metadata_json) ? row.metadata_json : undefined,\n  });\n}\n\nfunction mapPostgresChange(change: unknown): Change {\n  if (!isRecord(change)) {\n    throw new ActivityError(\"STORAGE_FAILURE\", \"Invalid change row returned by storage\");\n  }\n\n  return {\n    field: String(change.field),\n    label: String(change.label),\n    before: change.before,\n    after: change.after,\n    valueType: String(change.valueType) as ValueType,\n  };\n}\n\nfunction isContent(value: unknown): value is Content {\n  return isRecord(value) && typeof value.type === \"string\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction toActivityError(error: unknown, code: string, fallback: string) {\n  if (error instanceof ActivityError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new ActivityError(code, error.message);\n  }\n\n  return new ActivityError(code, fallback);\n}\n"],
+  "mappings": "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",
+  "names": []
+}