@absolutejs/sync-pack-favorites 0.1.0

package/README.md

@@ -0,0 +1,128 @@
+# @absolutejs/sync-pack-favorites
+
+Per-actor saved-resources pack for
+[`@absolutejs/sync`](https://github.com/absolutejs/sync). Each actor sees
+only their own rows; favoriting is idempotent (deterministic row id);
+optional join collection pairs each favorite with the host's resource
+row in one live subscription.
+
+```bash
+bun add @absolutejs/sync-pack-favorites
+```
+
+## Usage
+
+```ts
+import { createSyncEngine } from '@absolutejs/sync/engine';
+import { createFavoritesPack } from '@absolutejs/sync-pack-favorites';
+
+const engine = createSyncEngine();
+engine.registerPack(
+	createFavoritesPack({
+		getActorId: (ctx) => ctx.session.userId,
+	}),
+);
+```
+
+Then from the client:
+
+```ts
+// Toggle is the easy default — one round-trip, returns the new state.
+const { favorited } = await store.mutate({
+	args: { resourceKind: 'doc', resourceId: 'doc-123' },
+	name: 'favorites:toggle',
+});
+
+// Or favorite / unfavorite explicitly.
+await store.mutate({ args: { resourceKind: 'doc', resourceId: 'doc-123' }, name: 'favorites:favorite' });
+await store.mutate({ args: { resourceKind: 'doc', resourceId: 'doc-123' }, name: 'favorites:unfavorite' });
+```
+
+## The pack exposes
+
+| Surface     | Name                          | What it does                                                |
+| ----------- | ----------------------------- | ----------------------------------------------------------- |
+| Collection  | `favorites`                   | Per-actor list. Optional `params.resourceKind` filter       |
+| Mutation    | `favorites:favorite`          | Idempotent insert. Subsequent calls are no-ops              |
+| Mutation    | `favorites:unfavorite`        | Idempotent delete. No-op if the row never existed           |
+| Mutation    | `favorites:toggle`            | Insert if missing, delete if present. Returns `{ favorited }` |
+| Collection  | `favorites-with-resource` (opt) | Join with the host's resource table — see below           |
+
+## Row shape
+
+```ts
+type FavoriteRow = {
+	id: string;              // `${actorId}:${resourceKind}:${resourceId}` — deterministic
+	actorId: string;
+	resourceKind: string;    // app-level: "doc" | "task" | "issue" | ...
+	resourceId: string;
+	createdAt: number;
+};
+```
+
+The deterministic id means the same `(actor, kind, resource)` triple
+always maps to the same row — so duplicate `favorite` calls are
+idempotent at the storage layer, not just behaviorally.
+
+## Optional: `favorites-with-resource` join
+
+When you set `joinResources`, the pack additionally registers a join
+collection that pairs each favorite with the host's resource row (same
+pattern as comments-with-author from sync-pack-comments).
+
+```ts
+type DocRow = { id: string; title: string };
+
+engine.registerReader('docs', { all: () => db.docs.list() });
+engine.registerPack(
+	createFavoritesPack<MyCtx, DocRow>({
+		getActorId,
+		joinResources: {
+			table: 'docs',
+			// Default (row) => row.id; override if your resource id key isn't `id`.
+			// key: (doc) => doc.docId,
+			// Required: host supplies the resource-side hydrate.
+			hydrate: () => db.docs.list(),
+		},
+	}),
+);
+
+const view = await engine.subscribe<
+	FavoriteRow & { resource: DocRow },
+	{ resourceKind?: string }
+>({
+	collection: 'favorites-with-resource',
+	params: { resourceKind: 'doc' },
+	ctx,
+	onDiff: rerender,
+});
+// view.initial[0] === { ...favorite, resource: { id, title } }
+```
+
+Inner join — favorites whose resource has been deleted drop out of the
+join (but stay in the base `favorites` collection).
+
+## Storage
+
+Default: per-instance in-memory store. For a persistent backend, pass a
+custom `store`:
+
+```ts
+import { type FavoritesStore } from '@absolutejs/sync-pack-favorites';
+
+const store: FavoritesStore = {
+	getById: (id) => /* SELECT * FROM favorites WHERE id = $1 */,
+	reader: { all: () => /* SELECT */ },
+	writer: { insert, update, delete },
+};
+```
+
+## Multiple instances
+
+Pass a `prefix` to coexist with another favorites pack instance (e.g. a
+"team" set vs a "private" set):
+
+```ts
+engine.registerPack(createFavoritesPack({ prefix: 'team_', /* ... */ }));
+engine.registerPack(createFavoritesPack({ prefix: 'private_', /* ... */ }));
+```

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `@absolutejs/sync-pack-favorites` — per-actor saved resources.
+ *
+ * Owns a `favorites` table; rows are `(actorId, resourceKind, resourceId)`
+ * triples with a stable primary key derived from them, so toggling
+ * favorite/unfavorite is an upsert/delete with no extra bookkeeping.
+ *
+ * Each actor sees only their own rows. Optional `joinResources` registers
+ * a `favorites-with-resource` join collection that pairs each favorite
+ * with the host's resource row (same shape as comments-with-author from
+ * the comments pack). Useful when the UI wants "title + body + favorited?"
+ * in one subscription.
+ */
+import { type CollectionContext, type SyncPack, type TableReader, type TableWriter } from '@absolutejs/sync/engine';
+/** A single favorited resource for a single actor. */
+export type FavoriteRow = {
+    /** `${actorId}:${resourceKind}:${resourceId}` — deterministic so toggling is idempotent. */
+    id: string;
+    actorId: string;
+    /** App-level resource type ("doc", "task", "issue", ...). Lets one inbox span multiple kinds. */
+    resourceKind: string;
+    resourceId: string;
+    createdAt: number;
+};
+/** A `FavoriteRow` paired with the host's resource row, from the optional join. */
+export type FavoriteWithResource<ResourceRow = unknown> = FavoriteRow & {
+    resource: ResourceRow;
+};
+export type FavoritesStore = {
+    reader: TableReader<CollectionContext>;
+    writer: TableWriter<FavoriteRow, CollectionContext, unknown>;
+    getById: (id: string) => FavoriteRow | undefined;
+};
+export declare const createInMemoryFavoritesStore: () => FavoritesStore;
+export type JoinResourcesConfig<Ctx, ResourceRow = unknown> = {
+    /**
+     * The host's resource table name. Surfaced in `readsTables` so the
+     * dependency graph is reviewable. Required when the join is enabled
+     * (no default — many apps have multiple resource tables).
+     */
+    table: string;
+    /** Get the host resource's id (the join field). Default `(row) => row.id`. */
+    key?: (resource: ResourceRow) => string;
+    /**
+     * Host-side hydrate for the resources side of the join. The pack
+     * passes the subscription params + ctx; this returns candidate
+     * resources. The engine inner-joins on
+     * `favorite.resourceId === resource.id`.
+     */
+    hydrate: (params: {
+        actorId: string | undefined;
+        resourceKind?: string;
+    }, ctx: Ctx) => Iterable<ResourceRow> | Promise<Iterable<ResourceRow>>;
+};
+export type FavoritesPackConfig<Ctx = CollectionContext, ResourceRow = unknown> = {
+    prefix?: string;
+    getActorId?: (ctx: Ctx) => string | undefined;
+    /** Custom storage adapter. Default per-instance in-memory. */
+    store?: FavoritesStore;
+    /** Wall-clock. Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Optional join collection. When set, registers
+     * `favorites-with-resource` and adds the resource table to
+     * `readsTables`.
+     */
+    joinResources?: JoinResourcesConfig<Ctx, ResourceRow>;
+};
+/**
+ * Build a {@link SyncPack} that exposes a per-actor list of favorited
+ * host-side resources. Optional join collection pairs each favorite with
+ * its host resource row.
+ */
+export declare const createFavoritesPack: <Ctx = CollectionContext, ResourceRow = unknown>(config?: FavoritesPackConfig<Ctx, ResourceRow>) => SyncPack;

package/dist/index.js

@@ -0,0 +1,218 @@
+// @bun
+// src/index.ts
+import {
+  defineCollection,
+  defineJoinCollection,
+  defineMutation,
+  defineSchema,
+  defineSyncPack,
+  field,
+  UnauthorizedError
+} from "@absolutejs/sync/engine";
+var createInMemoryFavoritesStore = () => {
+  const rows = new Map;
+  return {
+    getById: (id) => rows.get(id),
+    reader: {
+      all: () => [...rows.values()]
+    },
+    writer: {
+      delete: (row) => {
+        rows.delete(row.id);
+      },
+      insert: (data) => {
+        rows.set(data.id, data);
+        return data;
+      },
+      update: (data) => {
+        const prior = rows.get(data.id);
+        const merged = { ...prior ?? {}, ...data };
+        rows.set(data.id, merged);
+        return merged;
+      }
+    }
+  };
+};
+var resolveActor = (getActorId, ctx) => {
+  const actorId = getActorId(ctx);
+  if (actorId === undefined || actorId === "") {
+    throw new UnauthorizedError("favorites mutation (no actor id)");
+  }
+  return actorId;
+};
+var rowId = (actorId, resourceKind, resourceId) => `${actorId}:${resourceKind}:${resourceId}`;
+var createFavoritesPack = (config = {}) => {
+  const prefix = config.prefix ?? "";
+  const table = `${prefix}favorites`;
+  const collectionName = table;
+  const joinCollectionName = `${prefix}favorites-with-resource`;
+  const favoriteMutationName = `${prefix}favorites:favorite`;
+  const unfavoriteMutationName = `${prefix}favorites:unfavorite`;
+  const toggleMutationName = `${prefix}favorites:toggle`;
+  const store = config.store ?? createInMemoryFavoritesStore();
+  const now = config.now ?? Date.now;
+  const getActorId = config.getActorId ?? ((ctx) => ctx.userId);
+  const joinResources = config.joinResources;
+  const resourceKey = joinResources?.key ?? ((row) => row.id);
+  const pack = {
+    name: "@absolutejs/sync-pack-favorites",
+    ownsTables: [table],
+    readsTables: joinResources === undefined ? [] : [joinResources.table],
+    version: "0.1.0",
+    schemas: defineSchema({
+      [table]: {
+        fields: {
+          id: field.string,
+          actorId: field.string,
+          resourceKind: field.string,
+          resourceId: field.string,
+          createdAt: field.number
+        }
+      }
+    }),
+    readers: { [table]: store.reader },
+    writers: { [table]: store.writer },
+    permissions: {
+      [table]: {
+        read: (ctx, row) => {
+          const callerId = getActorId(ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        insert: (ctx, row) => {
+          const callerId = getActorId(ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        update: (ctx, row) => {
+          const callerId = getActorId(ctx);
+          return callerId !== undefined && row.actorId === callerId;
+        },
+        delete: (ctx, row) => {
+          const callerId = getActorId(ctx);
+          if (callerId === undefined)
+            return false;
+          const ownerId = row.actorId ?? (() => {
+            const id = row.id;
+            return id === undefined ? undefined : store.getById(id)?.actorId;
+          })();
+          return ownerId === callerId;
+        }
+      }
+    },
+    collections: [
+      defineCollection({
+        name: collectionName,
+        tables: [table],
+        key: (row) => row.id,
+        hydrate: (params, ctx) => {
+          const callerId = getActorId(ctx);
+          if (callerId === undefined)
+            return [];
+          return store.reader.all(ctx).filter((row) => row.actorId === callerId && (params.resourceKind === undefined || row.resourceKind === params.resourceKind));
+        },
+        match: (row, params, ctx) => {
+          const callerId = getActorId(ctx);
+          if (callerId === undefined || row.actorId !== callerId)
+            return false;
+          return params.resourceKind === undefined || row.resourceKind === params.resourceKind;
+        },
+        authorize: (_params, ctx) => getActorId(ctx) !== undefined
+      })
+    ],
+    mutations: [
+      defineMutation({
+        name: favoriteMutationName,
+        handler: async (args, ctx, actions) => {
+          const actorId = resolveActor(getActorId, ctx);
+          const id = rowId(actorId, args.resourceKind, args.resourceId);
+          const existing = store.getById(id);
+          if (existing !== undefined)
+            return existing;
+          const row = {
+            actorId,
+            createdAt: now(),
+            id,
+            resourceId: args.resourceId,
+            resourceKind: args.resourceKind
+          };
+          return await actions.insert(table, row);
+        }
+      }),
+      defineMutation({
+        name: unfavoriteMutationName,
+        handler: async (args, ctx, actions) => {
+          const actorId = resolveActor(getActorId, ctx);
+          const id = rowId(actorId, args.resourceKind, args.resourceId);
+          if (store.getById(id) === undefined)
+            return;
+          await actions.delete(table, { id });
+        }
+      }),
+      defineMutation({
+        name: toggleMutationName,
+        handler: async (args, ctx, actions) => {
+          const actorId = resolveActor(getActorId, ctx);
+          const id = rowId(actorId, args.resourceKind, args.resourceId);
+          const existing = store.getById(id);
+          if (existing === undefined) {
+            const row = {
+              actorId,
+              createdAt: now(),
+              id,
+              resourceId: args.resourceId,
+              resourceKind: args.resourceKind
+            };
+            await actions.insert(table, row);
+            return { favorited: true };
+          }
+          await actions.delete(table, { id });
+          return { favorited: false };
+        }
+      })
+    ]
+  };
+  if (joinResources !== undefined) {
+    const resourceHydrate = joinResources.hydrate;
+    pack.joinCollections = [
+      defineJoinCollection({
+        name: joinCollectionName,
+        key: (out) => out.id,
+        left: {
+          table,
+          hydrate: (params, ctx) => {
+            const callerId = getActorId(ctx);
+            if (callerId === undefined)
+              return [];
+            return store.reader.all(ctx).filter((row) => row.actorId === callerId && (params.resourceKind === undefined || row.resourceKind === params.resourceKind));
+          },
+          key: (row) => row.id,
+          on: (row) => row.resourceId,
+          match: (row, params, ctx) => {
+            const callerId = getActorId(ctx);
+            if (callerId === undefined || row.actorId !== callerId)
+              return false;
+            return params.resourceKind === undefined || row.resourceKind === params.resourceKind;
+          }
+        },
+        right: {
+          table: joinResources.table,
+          hydrate: (params, ctx) => resourceHydrate({
+            actorId: getActorId(ctx),
+            resourceKind: params.resourceKind
+          }, ctx),
+          key: (resource) => resourceKey(resource),
+          on: (resource) => resourceKey(resource)
+        },
+        select: (favorite, resource) => ({ ...favorite, resource }),
+        authorize: (_params, ctx) => getActorId(ctx) !== undefined
+      })
+    ];
+  }
+  return defineSyncPack(pack);
+};
+export {
+  createInMemoryFavoritesStore,
+  createFavoritesPack
+};
+
+//# debugId=E27906193B10A86564756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * `@absolutejs/sync-pack-favorites` — per-actor saved resources.\n *\n * Owns a `favorites` table; rows are `(actorId, resourceKind, resourceId)`\n * triples with a stable primary key derived from them, so toggling\n * favorite/unfavorite is an upsert/delete with no extra bookkeeping.\n *\n * Each actor sees only their own rows. Optional `joinResources` registers\n * a `favorites-with-resource` join collection that pairs each favorite\n * with the host's resource row (same shape as comments-with-author from\n * the comments pack). Useful when the UI wants \"title + body + favorited?\"\n * in one subscription.\n */\n\nimport {\n\tdefineCollection,\n\tdefineJoinCollection,\n\tdefineMutation,\n\tdefineSchema,\n\tdefineSyncPack,\n\tfield,\n\tUnauthorizedError,\n\ttype CollectionContext,\n\ttype SyncPack,\n\ttype TableReader,\n\ttype TableWriter\n} from '@absolutejs/sync/engine';\n\n/** A single favorited resource for a single actor. */\nexport type FavoriteRow = {\n\t/** `${actorId}:${resourceKind}:${resourceId}` — deterministic so toggling is idempotent. */\n\tid: string;\n\tactorId: string;\n\t/** App-level resource type (\"doc\", \"task\", \"issue\", ...). Lets one inbox span multiple kinds. */\n\tresourceKind: string;\n\tresourceId: string;\n\tcreatedAt: number;\n};\n\n/** A `FavoriteRow` paired with the host's resource row, from the optional join. */\nexport type FavoriteWithResource<ResourceRow = unknown> = FavoriteRow & {\n\tresource: ResourceRow;\n};\n\nexport type FavoritesStore = {\n\treader: TableReader<CollectionContext>;\n\twriter: TableWriter<FavoriteRow, CollectionContext, unknown>;\n\tgetById: (id: string) => FavoriteRow | undefined;\n};\n\nexport const createInMemoryFavoritesStore = (): FavoritesStore => {\n\tconst rows = new Map<string, FavoriteRow>();\n\treturn {\n\t\tgetById: (id) => rows.get(id),\n\t\treader: {\n\t\t\tall: () => [...rows.values()]\n\t\t},\n\t\twriter: {\n\t\t\tdelete: (row) => {\n\t\t\t\trows.delete((row as { id: string }).id);\n\t\t\t},\n\t\t\tinsert: (data) => {\n\t\t\t\trows.set(data.id, data);\n\t\t\t\treturn data;\n\t\t\t},\n\t\t\tupdate: (data) => {\n\t\t\t\tconst prior = rows.get(data.id);\n\t\t\t\tconst merged = { ...(prior ?? {}), ...data } as FavoriteRow;\n\t\t\t\trows.set(data.id, merged);\n\t\t\t\treturn merged;\n\t\t\t}\n\t\t}\n\t};\n};\n\nexport type JoinResourcesConfig<Ctx, ResourceRow = unknown> = {\n\t/**\n\t * The host's resource table name. Surfaced in `readsTables` so the\n\t * dependency graph is reviewable. Required when the join is enabled\n\t * (no default — many apps have multiple resource tables).\n\t */\n\ttable: string;\n\t/** Get the host resource's id (the join field). Default `(row) => row.id`. */\n\tkey?: (resource: ResourceRow) => string;\n\t/**\n\t * Host-side hydrate for the resources side of the join. The pack\n\t * passes the subscription params + ctx; this returns candidate\n\t * resources. The engine inner-joins on\n\t * `favorite.resourceId === resource.id`.\n\t */\n\thydrate: (\n\t\tparams: { actorId: string | undefined; resourceKind?: string },\n\t\tctx: Ctx\n\t) => Iterable<ResourceRow> | Promise<Iterable<ResourceRow>>;\n};\n\nexport type FavoritesPackConfig<Ctx = CollectionContext, ResourceRow = unknown> = {\n\tprefix?: string;\n\tgetActorId?: (ctx: Ctx) => string | undefined;\n\t/** Custom storage adapter. Default per-instance in-memory. */\n\tstore?: FavoritesStore;\n\t/** Wall-clock. Default `Date.now`. */\n\tnow?: () => number;\n\t/**\n\t * Optional join collection. When set, registers\n\t * `favorites-with-resource` and adds the resource table to\n\t * `readsTables`.\n\t */\n\tjoinResources?: JoinResourcesConfig<Ctx, ResourceRow>;\n};\n\nconst resolveActor = (\n\tgetActorId: NonNullable<FavoritesPackConfig['getActorId']>,\n\tctx: unknown\n): string => {\n\tconst actorId = getActorId(ctx as CollectionContext);\n\tif (actorId === undefined || actorId === '') {\n\t\tthrow new UnauthorizedError('favorites mutation (no actor id)');\n\t}\n\treturn actorId;\n};\n\nconst rowId = (\n\tactorId: string,\n\tresourceKind: string,\n\tresourceId: string\n): string => `${actorId}:${resourceKind}:${resourceId}`;\n\n/**\n * Build a {@link SyncPack} that exposes a per-actor list of favorited\n * host-side resources. Optional join collection pairs each favorite with\n * its host resource row.\n */\nexport const createFavoritesPack = <\n\tCtx = CollectionContext,\n\tResourceRow = unknown\n>(\n\tconfig: FavoritesPackConfig<Ctx, ResourceRow> = {}\n): SyncPack => {\n\tconst prefix = config.prefix ?? '';\n\tconst table = `${prefix}favorites`;\n\tconst collectionName = table;\n\tconst joinCollectionName = `${prefix}favorites-with-resource`;\n\tconst favoriteMutationName = `${prefix}favorites:favorite`;\n\tconst unfavoriteMutationName = `${prefix}favorites:unfavorite`;\n\tconst toggleMutationName = `${prefix}favorites:toggle`;\n\tconst store = config.store ?? createInMemoryFavoritesStore();\n\tconst now = config.now ?? Date.now;\n\tconst getActorId = (config.getActorId ??\n\t\t((ctx: CollectionContext) =>\n\t\t\t(ctx as { userId?: string }).userId)) as (\n\t\tctx: CollectionContext\n\t) => string | undefined;\n\tconst joinResources = config.joinResources;\n\tconst resourceKey = (joinResources?.key ?? ((row: unknown) =>\n\t\t(row as { id: string }).id)) as (resource: unknown) => string;\n\n\ttype Params = { resourceKind?: string };\n\n\tconst pack: SyncPack = {\n\t\tname: '@absolutejs/sync-pack-favorites',\n\t\townsTables: [table],\n\t\treadsTables:\n\t\t\tjoinResources === undefined ? [] : [joinResources.table],\n\t\tversion: '0.1.0',\n\n\t\tschemas: defineSchema({\n\t\t\t[table]: {\n\t\t\t\tfields: {\n\t\t\t\t\tid: field.string,\n\t\t\t\t\tactorId: field.string,\n\t\t\t\t\tresourceKind: field.string,\n\t\t\t\t\tresourceId: field.string,\n\t\t\t\t\tcreatedAt: field.number\n\t\t\t\t}\n\t\t\t}\n\t\t}),\n\n\t\treaders: { [table]: store.reader },\n\t\twriters: { [table]: store.writer },\n\n\t\tpermissions: {\n\t\t\t[table]: {\n\t\t\t\tread: (ctx: unknown, row: FavoriteRow) => {\n\t\t\t\t\tconst callerId = getActorId(ctx as CollectionContext);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\tinsert: (ctx: unknown, row: FavoriteRow) => {\n\t\t\t\t\tconst callerId = getActorId(ctx as CollectionContext);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\tupdate: (ctx: unknown, row: FavoriteRow) => {\n\t\t\t\t\tconst callerId = getActorId(ctx as CollectionContext);\n\t\t\t\t\treturn callerId !== undefined && row.actorId === callerId;\n\t\t\t\t},\n\t\t\t\tdelete: (ctx: unknown, row: FavoriteRow) => {\n\t\t\t\t\tconst callerId = getActorId(ctx as CollectionContext);\n\t\t\t\t\tif (callerId === undefined) return false;\n\t\t\t\t\tconst ownerId =\n\t\t\t\t\t\t(row as { actorId?: string }).actorId ??\n\t\t\t\t\t\t(() => {\n\t\t\t\t\t\t\tconst id = (row as { id?: string }).id;\n\t\t\t\t\t\t\treturn id === undefined\n\t\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t\t: store.getById(id)?.actorId;\n\t\t\t\t\t\t})();\n\t\t\t\t\treturn ownerId === callerId;\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\tcollections: [\n\t\t\tdefineCollection<FavoriteRow, Params, CollectionContext>({\n\t\t\t\tname: collectionName,\n\t\t\t\ttables: [table],\n\t\t\t\tkey: (row) => row.id,\n\t\t\t\thydrate: (params, ctx) => {\n\t\t\t\t\tconst callerId = getActorId(ctx);\n\t\t\t\t\tif (callerId === undefined) return [];\n\t\t\t\t\treturn (store.reader.all(ctx) as FavoriteRow[]).filter(\n\t\t\t\t\t\t(row) =>\n\t\t\t\t\t\t\trow.actorId === callerId &&\n\t\t\t\t\t\t\t(params.resourceKind === undefined ||\n\t\t\t\t\t\t\t\trow.resourceKind === params.resourceKind)\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tmatch: (row, params, ctx) => {\n\t\t\t\t\tconst callerId = getActorId(ctx);\n\t\t\t\t\tif (callerId === undefined || row.actorId !== callerId)\n\t\t\t\t\t\treturn false;\n\t\t\t\t\treturn (\n\t\t\t\t\t\tparams.resourceKind === undefined ||\n\t\t\t\t\t\trow.resourceKind === params.resourceKind\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tauthorize: (_params, ctx) =>\n\t\t\t\t\tgetActorId(ctx as CollectionContext) !== undefined\n\t\t\t})\n\t\t],\n\n\t\tmutations: [\n\t\t\tdefineMutation<\n\t\t\t\t{ resourceKind: string; resourceId: string },\n\t\t\t\tCollectionContext,\n\t\t\t\tFavoriteRow\n\t\t\t>({\n\t\t\t\tname: favoriteMutationName,\n\t\t\t\thandler: async (args, ctx, actions) => {\n\t\t\t\t\tconst actorId = resolveActor(getActorId, ctx);\n\t\t\t\t\tconst id = rowId(actorId, args.resourceKind, args.resourceId);\n\t\t\t\t\tconst existing = store.getById(id);\n\t\t\t\t\tif (existing !== undefined) return existing;\n\t\t\t\t\tconst row: FavoriteRow = {\n\t\t\t\t\t\tactorId,\n\t\t\t\t\t\tcreatedAt: now(),\n\t\t\t\t\t\tid,\n\t\t\t\t\t\tresourceId: args.resourceId,\n\t\t\t\t\t\tresourceKind: args.resourceKind\n\t\t\t\t\t};\n\t\t\t\t\treturn (await actions.insert(table, row)) as FavoriteRow;\n\t\t\t\t}\n\t\t\t}),\n\t\t\tdefineMutation<\n\t\t\t\t{ resourceKind: string; resourceId: string },\n\t\t\t\tCollectionContext,\n\t\t\t\tvoid\n\t\t\t>({\n\t\t\t\tname: unfavoriteMutationName,\n\t\t\t\thandler: async (args, ctx, actions) => {\n\t\t\t\t\tconst actorId = resolveActor(getActorId, ctx);\n\t\t\t\t\tconst id = rowId(actorId, args.resourceKind, args.resourceId);\n\t\t\t\t\tif (store.getById(id) === undefined) return;\n\t\t\t\t\tawait actions.delete(table, { id });\n\t\t\t\t}\n\t\t\t}),\n\t\t\t// Convenience: toggle is one round-trip from the client.\n\t\t\tdefineMutation<\n\t\t\t\t{ resourceKind: string; resourceId: string },\n\t\t\t\tCollectionContext,\n\t\t\t\t{ favorited: boolean }\n\t\t\t>({\n\t\t\t\tname: toggleMutationName,\n\t\t\t\thandler: async (args, ctx, actions) => {\n\t\t\t\t\tconst actorId = resolveActor(getActorId, ctx);\n\t\t\t\t\tconst id = rowId(actorId, args.resourceKind, args.resourceId);\n\t\t\t\t\tconst existing = store.getById(id);\n\t\t\t\t\tif (existing === undefined) {\n\t\t\t\t\t\tconst row: FavoriteRow = {\n\t\t\t\t\t\t\tactorId,\n\t\t\t\t\t\t\tcreatedAt: now(),\n\t\t\t\t\t\t\tid,\n\t\t\t\t\t\t\tresourceId: args.resourceId,\n\t\t\t\t\t\t\tresourceKind: args.resourceKind\n\t\t\t\t\t\t};\n\t\t\t\t\t\tawait actions.insert(table, row);\n\t\t\t\t\t\treturn { favorited: true };\n\t\t\t\t\t}\n\t\t\t\t\tawait actions.delete(table, { id });\n\t\t\t\t\treturn { favorited: false };\n\t\t\t\t}\n\t\t\t})\n\t\t]\n\t};\n\n\tif (joinResources !== undefined) {\n\t\tconst resourceHydrate = joinResources.hydrate;\n\t\tpack.joinCollections = [\n\t\t\tdefineJoinCollection<\n\t\t\t\tFavoriteRow,\n\t\t\t\tunknown,\n\t\t\t\tFavoriteWithResource,\n\t\t\t\tParams,\n\t\t\t\tCollectionContext\n\t\t\t>({\n\t\t\t\tname: joinCollectionName,\n\t\t\t\tkey: (out) => out.id,\n\t\t\t\tleft: {\n\t\t\t\t\ttable,\n\t\t\t\t\thydrate: (params, ctx) => {\n\t\t\t\t\t\tconst callerId = getActorId(ctx);\n\t\t\t\t\t\tif (callerId === undefined) return [];\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tstore.reader.all(ctx) as FavoriteRow[]\n\t\t\t\t\t\t).filter(\n\t\t\t\t\t\t\t(row) =>\n\t\t\t\t\t\t\t\trow.actorId === callerId &&\n\t\t\t\t\t\t\t\t(params.resourceKind === undefined ||\n\t\t\t\t\t\t\t\t\trow.resourceKind === params.resourceKind)\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t\tkey: (row) => row.id,\n\t\t\t\t\ton: (row) => row.resourceId,\n\t\t\t\t\tmatch: (row, params, ctx) => {\n\t\t\t\t\t\tconst callerId = getActorId(ctx);\n\t\t\t\t\t\tif (callerId === undefined || row.actorId !== callerId)\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\tparams.resourceKind === undefined ||\n\t\t\t\t\t\t\trow.resourceKind === params.resourceKind\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tright: {\n\t\t\t\t\ttable: joinResources.table,\n\t\t\t\t\thydrate: (params, ctx) =>\n\t\t\t\t\t\tresourceHydrate(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tactorId: getActorId(ctx),\n\t\t\t\t\t\t\t\tresourceKind: params.resourceKind\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tctx as Ctx\n\t\t\t\t\t\t) as Iterable<unknown>,\n\t\t\t\t\tkey: (resource) => resourceKey(resource),\n\t\t\t\t\ton: (resource) => resourceKey(resource)\n\t\t\t\t},\n\t\t\t\tselect: (favorite, resource) => ({ ...favorite, resource }),\n\t\t\t\tauthorize: (_params, ctx) =>\n\t\t\t\t\tgetActorId(ctx as CollectionContext) !== undefined\n\t\t\t})\n\t\t];\n\t}\n\n\treturn defineSyncPack(pack);\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "E27906193B10A86564756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@absolutejs/sync-pack-favorites",
+	"version": "0.1.0",
+	"description": "Per-actor saved-resources pack for @absolutejs/sync — favorite/unfavorite/list with optional join to host resources",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/sync-packs.git",
+		"directory": "favorites"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"absolutejs",
+		"sync",
+		"sync-pack",
+		"favorites",
+		"bookmarks"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run typecheck && bun run test && bun run build && bun publish"
+	},
+	"peerDependencies": {
+		"@absolutejs/sync": ">= 1.9.2"
+	},
+	"devDependencies": {
+		"@absolutejs/sync": "^1.9.2",
+		"@types/bun": "1.3.14",
+		"prettier": "3.5.3",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": ["dist", "README.md"]
+}