@absolutejs/sync-pack-digest 0.2.2 → 0.2.3

package/dist/manifest.json

@@ -0,0 +1,78 @@
+{
+	"contract": 1,
+	"identity": {
+		"accent": "#a855f7",
+		"category": "sync",
+		"description": "Scheduled per-actor digest pack for `@absolutejs/sync` — one `engine.registerPack(createDigestPack(...))` adds a cron-fired schedule that iterates your actors, builds each one’s digest since their personal cursor, and hands it to your sender (the pack owns cursors and cadence, never transport). Per-actor failures are isolated; `dryRun` previews what would send.",
+		"docsUrl": "https://github.com/absolutejs/sync-packs/tree/main/digest",
+		"name": "@absolutejs/sync-pack-digest",
+		"tagline": "Send everyone a personal summary email on a schedule."
+	},
+	"settings": {
+		"type": "object",
+		"properties": {
+			"cron": {
+				"description": "When digests fire (cron syntax). Default Mondays at 08:00.",
+				"examples": [
+					"0 8 * * 1"
+				],
+				"title": "Digest schedule",
+				"type": "string"
+			},
+			"dryRun": {
+				"description": "Build digests but don’t send or advance cursors — preview what the next fire would deliver.",
+				"title": "Preview mode",
+				"type": "boolean"
+			},
+			"maxActorsPerFire": {
+				"description": "How many people are processed per fire; the rest wait for the next one. Default 1000.",
+				"minimum": 1,
+				"title": "People per fire",
+				"type": "integer"
+			},
+			"minHoursBetweenDigests": {
+				"description": "Someone whose last digest is fresher than this is skipped. Default 168 (one week).",
+				"minimum": 0,
+				"title": "Minimum hours between digests",
+				"type": "number"
+			},
+			"prefix": {
+				"description": "Name prefix for the pack’s cursor table, collection, and schedule.",
+				"title": "Name prefix",
+				"type": "string"
+			}
+		}
+	},
+	"wiring": [
+		{
+			"description": "Rides @absolutejs/sync’s engine recipe: `engine` is its module-scope binding (mount the scheduled plugin so cron patterns actually fire). Delivery composes with @absolutejs/dispatch or any sender.",
+			"id": "default",
+			"server": {
+				"code": "engine.registerPack(createDigestPack({\n\t// TODO: what goes in one person’s digest since their last one.\n\tbuildDigest: async (actorId, since) => null, // null skips silently\n\t// TODO: who receives digests (your data layer is the source of truth).\n\tlistActors: () => [],\n\t// TODO: deliver it — e.g. dispatcher.email({ to, subject, text }).\n\tsend: async (message) => {},\n\t...${settings}\n}));",
+				"imports": [
+					{
+						"from": "@absolutejs/sync-pack-digest",
+						"names": [
+							"createDigestPack"
+						]
+					}
+				],
+				"placement": "module-scope"
+			},
+			"title": "Register scheduled digests on the sync engine"
+		}
+	],
+	"tools": {
+		"pack_surface": {
+			"annotations": {
+				"readOnlyHint": true
+			},
+			"description": "What this digest pack adds to the sync engine: the cursor table it owns, its collection, and the digest schedule with its cron pattern.",
+			"input": {
+				"type": "object",
+				"properties": {}
+			},
+			"kind": "runtime"
+		}
+	}
+}

package/package.json

@@ -1,12 +1,16 @@
 {
 	"name": "@absolutejs/sync-pack-digest",
-	"version": "0.2.2",
+	"version": "0.2.3",
 	"description": "Scheduled per-actor digest pack for @absolutejs/sync — cron-fired, cursor-managed, transport-agnostic",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/absolutejs/sync-packs.git",
 		"directory": "digest"
 	},
+	"homepage": "https://github.com/absolutejs/sync-packs/tree/main/digest",
+	"bugs": {
+		"url": "https://github.com/absolutejs/sync-packs/issues"
+	},
 	"main": "./dist/index.js",
 	"module": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -25,7 +29,7 @@
 		"email"
 	],
 	"scripts": {
-		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync && tsc --project tsconfig.build.json",
+		"build": "rm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --sourcemap --target=bun --external @absolutejs/sync && tsc --project tsconfig.build.json && absolute-manifest emit",
 		"test": "bun test",
 		"typecheck": "tsc --noEmit",
 		"format": "prettier --write \"./**/*.{ts,json,md}\"",
@@ -45,7 +49,23 @@
 			"types": "./dist/index.d.ts",
 			"import": "./dist/index.js",
 			"default": "./dist/index.js"
-		}
+		},
+		"./manifest": {
+			"types": "./dist/manifest.d.ts",
+			"import": "./dist/manifest.js",
+			"default": "./dist/manifest.js"
+		},
+		"./manifest.json": "./dist/manifest.json"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"absolutejs": {
+		"manifestContract": 1
 	},
-	"files": ["dist", "README.md"]
+	"dependencies": {
+		"@absolutejs/manifest": "^0.1.0",
+		"@sinclair/typebox": "^0.34.0"
+	}
 }