@evcraddock/slug-api 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -20,11 +20,23 @@ Generated sites should keep local API route modules that compose these helpers w
20
20
 
21
21
  Generated sites import this document and pass its identity/version explicitly to `createApiMetaResponse` via `contract`. The `/api/v1/meta` response exposes `api.contract`; the document repeats it in `x-slugkit-contract` and uses the contract version in `info.version`. The legacy `api.version` remains the API routing generation marker and is not evidence of a specific contract.
22
22
 
23
+ ## Incoming retention contract 3.0.0
24
+
25
+ **Breaking:** package **2.0.0** carries contract **3.0.0**. Update with `npm install --save-exact @evcraddock/slug-api@2.0.0` as part of reviewed site adoption, not as a standalone deployment. Explicit incoming-copy removal purges bodies, copy metadata and delivery aliases rather than keeping permanent tombstones. GET/DELETE response shapes and route prefixes are unchanged, but removed remote activities/objects may return with a new copy ID and higher receipt position. Buffered duplicates remain suppressed; no historical duplicate/equivocation binding survives removal. Old-ID retries never remove a replacement copy. Clients own long-term recognition using scoped post kind/objectId and boost kind/activityId, preserving actor/sharing-follow boundaries and distinct boosts of the same original.
26
+
27
+ The package supplies the matching contract/metadata, not site-owned cleanup implementation. Adopt the incoming service and regressions together; no new schema migration is needed on the current template schema. **Do not deploy server retention or run legacy cleanup before Rott task-5a4a4e82 verifies redelivery recognition and repeat cleanup.** See the [operator and client coordination guide](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/incoming-activity-retention.md). Existing-metadata cleanup is explicitly scoped/bounded/operator-only, not a startup migration. Production inspection/deletion/deployment remain separately authorized. Package publication does not establish site adoption or client readiness; the rollout gate still applies.
28
+
29
+ ## Contact deletion contract 2.3.0
30
+
31
+ The unreleased source contract adds safe deletion of contacts whose only follow references are inactive. This is a compatible relaxation of deletion restrictions, classified as additive: existing requests, response shapes, required non-null `Following.accountId`, authentication and route prefixes are unchanged. Pending/accepted follows and unrelated references still return `409`. Site-owned deletion atomically detaches inactive history and removes the contact and its owned accounts without purging incoming bodies, snapshots, aliases or tombstones. Detached history is hidden from following lists and activity routes return `404` until explicit refollow reattaches the same identity to a real account; cursors and duplicate suppression survive. Direct account-delete/URL-change guards are unchanged.
32
+
33
+ Adopt migration 031 and the site-owned contacts/following changes together; updating this package alone does not implement the behavior. See [adoption guidance](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/package-updates.md#contact-deletion-after-unfollow-contract-230). No npm versions/pins/lockfile are changed by implementation; release, migration execution, site deployment and production contact cleanup remain separate authorizations.
34
+
23
35
  ## Incoming activity contract 2.2.0
24
36
 
25
- Package 1.0.0 carries contract 2.2.0. Compared with the previously published contract 1.1.0, following responses replace `contactId` with `accountId`; update clients before adopting the new contract. The source contract's approved 2.1.0 → 2.2.0 minor increment adds boosts to the per-followed-account GET/DELETE buffer. Incoming pages contain `IncomingPost` or `IncomingBoost` without an opt-in filter; existing post payloads and Slug CLI commands remain unchanged. Readers must branch on `kind`, distinguish the followed sharing account from the original author, and handle Account-shaped unsaved-author snapshots with null stored IDs and no permanent Contact creation. Download, explicit removal and reading remain independent; there is no shared-read authority or automatic retention policy. See [Spec 12](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/specs/12-incoming-activity.md), [isolated evidence](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/incoming-activity-evidence.md) and [consumer reconciliation](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/incoming-activity-consumers.md).
37
+ The unreleased source contract adds boosts to the existing per-followed-account GET/DELETE activity buffer as the explicitly approved minor feature increment. Incoming pages contain `IncomingPost` or `IncomingBoost` without an opt-in filter; existing post payloads and Slug CLI commands remain unchanged. Readers must branch on `kind`, distinguish the followed sharing account from the original author, and handle Account-shaped unsaved-author snapshots with null stored IDs and no permanent Contact creation. Download, explicit removal and reading remain independent; there is no shared-read authority or automatic retention policy. See [Spec 12](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/specs/12-incoming-activity.md), [isolated evidence](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/incoming-activity-evidence.md) and [consumer reconciliation](https://forge.caradoc.com/erik/slugkit/src/branch/main/docs/incoming-activity-consumers.md).
26
38
 
27
- The API package supplies the shared schema/helpers, not website inbox handlers, storage migrations or deployment. Adopt site-owned changes and migration 030 before claiming implementation support. The package-to-contract mapping is recorded in `contract.json`; verify it and its OpenAPI digest after publication. Publishing these references does not establish that slugkit.com or another deployed website implements the new operations.
39
+ The API package supplies the shared schema/helpers, not website inbox handlers, storage migrations or deployment. Adopt site-owned changes and migration 030 before claiming implementation support. This source version is not a published package mapping or proof of slugkit.com availability; npm version selection and publication remain explicitly gated.
28
40
 
29
41
  ## Version and release policy
30
42
 
@@ -1,2 +1,2 @@
1
1
  export declare const SLUGKIT_CONTRACT_ID = "slugkit-management-api";
2
- export declare const SLUGKIT_CONTRACT_VERSION = "2.2.0";
2
+ export declare const SLUGKIT_CONTRACT_VERSION = "3.0.0";
package/dist/contract.js CHANGED
@@ -1,2 +1,2 @@
1
1
  export const SLUGKIT_CONTRACT_ID = "slugkit-management-api";
2
- export const SLUGKIT_CONTRACT_VERSION = "2.2.0";
2
+ export const SLUGKIT_CONTRACT_VERSION = "3.0.0";
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "id": "slugkit-management-api",
3
- "version": "2.2.0",
3
+ "version": "3.0.0",
4
4
  "packageName": "@evcraddock/slug-api",
5
- "packageVersion": "1.0.0",
5
+ "packageVersion": "2.0.0",
6
6
  "artifact": "openapi.json",
7
- "sha256": "183e57ea59d2e37f9ea862940a94f38966b2c418d244ee9ff8f355bac1986925",
8
- "changeType": "additive"
7
+ "sha256": "33a5fa76a81b8cebc98562bd3accd9024b1e779f961c025aaf678f2d6ca8b35c",
8
+ "changeType": "breaking"
9
9
  }
package/dist/openapi.d.ts CHANGED
@@ -2,11 +2,11 @@ export declare const openApiDocument: {
2
2
  readonly openapi: "3.1.0";
3
3
  readonly "x-slugkit-contract": {
4
4
  readonly id: "slugkit-management-api";
5
- readonly version: "2.2.0";
5
+ readonly version: "3.0.0";
6
6
  };
7
7
  readonly info: {
8
8
  readonly title: "Slugkit API";
9
- readonly version: "2.2.0";
9
+ readonly version: "3.0.0";
10
10
  };
11
11
  readonly servers: readonly [{
12
12
  readonly url: "/api/v1";
@@ -579,6 +579,7 @@ export declare const openApiDocument: {
579
579
  readonly delete: {
580
580
  readonly operationId: "contacts.delete";
581
581
  readonly summary: "Delete a contact by ID";
582
+ readonly description: "Deletes the contact and its owned accounts after detaching inactive follow history. Pending or accepted follows and unrelated references return 409. Retained incoming snapshots and delivery identities are not deleted. Detached history is omitted from following lists and activity routes return 404 until refollow reattaches it to an account.";
582
583
  readonly security: readonly [{
583
584
  readonly bearerAuth: readonly [];
584
585
  }];
@@ -1469,6 +1470,7 @@ export declare const openApiDocument: {
1469
1470
  readonly get: {
1470
1471
  readonly operationId: "following.list";
1471
1472
  readonly summary: "List following records";
1473
+ readonly description: "Lists account-backed following records. Inactive history detached by contact deletion is internal and omitted; accountId remains required and non-null.";
1472
1474
  readonly security: readonly [{
1473
1475
  readonly bearerAuth: readonly [];
1474
1476
  }];
@@ -1527,6 +1529,7 @@ export declare const openApiDocument: {
1527
1529
  readonly post: {
1528
1530
  readonly operationId: "following.create";
1529
1531
  readonly summary: "Follow a target";
1532
+ readonly description: "Reuses an inactive following identity, including history detached by contact deletion, and attaches it to the uniquely resolved contact-owned account. Retained incoming snapshots, cursors and deduplication identities survive refollow.";
1530
1533
  readonly security: readonly [{
1531
1534
  readonly bearerAuth: readonly [];
1532
1535
  }];
@@ -1598,7 +1601,7 @@ export declare const openApiDocument: {
1598
1601
  readonly get: {
1599
1602
  readonly operationId: "following.activity.list";
1600
1603
  readonly summary: "Download buffered posts and boosts from one followed account";
1601
- readonly description: "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive deletion and remain usable when hasMore is false. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.";
1604
+ readonly description: "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive full copy deletion and remain usable when hasMore is false, even after the buffer empties. Redelivery after removal gets a new copy ID and a higher receipt position; client read history must use remote identities instead of copy IDs/cursors. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.";
1602
1605
  readonly security: readonly [{
1603
1606
  readonly bearerAuth: readonly [];
1604
1607
  }];
@@ -1687,7 +1690,7 @@ export declare const openApiDocument: {
1687
1690
  readonly delete: {
1688
1691
  readonly operationId: "following.activity.remove";
1689
1692
  readonly summary: "Remove selected buffered website copies";
1690
- readonly description: "Atomic body removal in the selected followed account and configured actor only. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical requests after uncertain responses; removed may be zero. No read or persistence acknowledgment. Bodies are removed; minimal deduplication identities remain indefinitely.";
1693
+ readonly description: "Contract 3.0.0: atomically removes selected website copies, bodies and all delivery/deduplication metadata in the followed-account/configured-actor scope. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical copy IDs after uncertain responses; removed may be zero and old IDs cannot remove a newly redelivered copy. No read or persistence acknowledgment. After removal the same remote activity/object may return with a new copy ID and a higher receipt position. Clients own long-term read/redelivery recognition; deduplication lasts only while buffered.";
1691
1694
  readonly security: readonly [{
1692
1695
  readonly bearerAuth: readonly [];
1693
1696
  }];
@@ -1717,7 +1720,7 @@ export declare const openApiDocument: {
1717
1720
  };
1718
1721
  readonly responses: {
1719
1722
  readonly "200": {
1720
- readonly description: "Number of copies actually removed by this request; zero is a successful idempotent retry, not an error.";
1723
+ readonly description: "Number of copy metadata records actually removed, including selected legacy body-less records; zero is a successful idempotent retry, not an error.";
1721
1724
  readonly content: {
1722
1725
  readonly "application/json": {
1723
1726
  readonly schema: {
@@ -2788,7 +2791,7 @@ export declare const openApiDocument: {
2788
2791
  };
2789
2792
  readonly version: {
2790
2793
  readonly type: "string";
2791
- readonly const: "2.2.0";
2794
+ readonly const: "3.0.0";
2792
2795
  };
2793
2796
  };
2794
2797
  };
@@ -3495,7 +3498,7 @@ export declare const openApiDocument: {
3495
3498
  readonly id: {
3496
3499
  readonly type: "string";
3497
3500
  readonly format: "uuid";
3498
- readonly description: "Opaque buffered-copy identity, not an activity or original-object ID. Treat as opaque and use only for this followed account.";
3501
+ readonly description: "Opaque buffered-copy identity, not a durable read-history key or remote activity/object ID. Use only for this actor/following scope. Redelivery after removal receives a new ID; recognize consumed posts by scoped kind/objectId.";
3499
3502
  };
3500
3503
  readonly kind: {
3501
3504
  readonly type: "string";
@@ -3601,13 +3604,13 @@ export declare const openApiDocument: {
3601
3604
  };
3602
3605
  readonly IncomingBoost: {
3603
3606
  readonly type: "object";
3604
- readonly description: "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original; retries of an observed ID never resurrect a removed copy. Existing post payloads are unchanged.";
3607
+ readonly description: "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original. Repeats are suppressed only while buffered; after explicit removal the same Announce may return as a new copy. Existing post payloads are unchanged.";
3605
3608
  readonly required: readonly ["id", "kind", "activityId", "objectId", "objectType", "url", "title", "contentHtml", "contentText", "publishedAt", "sharedAt", "receivedAt", "sharingAccount", "sharingContact", "authorAccount", "authorContact"];
3606
3609
  readonly properties: {
3607
3610
  readonly id: {
3608
3611
  readonly type: "string";
3609
3612
  readonly format: "uuid";
3610
- readonly description: "Opaque buffered-copy identity; not the Announce or original-object ID.";
3613
+ readonly description: "Opaque buffered-copy identity; not the Announce, original-object ID or a durable read key. Redelivery after removal receives a new ID; recognize consumed boosts by scoped kind/activityId, not objectId.";
3611
3614
  };
3612
3615
  readonly kind: {
3613
3616
  readonly type: "string";
package/dist/openapi.js CHANGED
@@ -433,6 +433,7 @@ export const openApiDocument = {
433
433
  delete: {
434
434
  operationId: "contacts.delete",
435
435
  summary: "Delete a contact by ID",
436
+ description: "Deletes the contact and its owned accounts after detaching inactive follow history. Pending or accepted follows and unrelated references return 409. Retained incoming snapshots and delivery identities are not deleted. Detached history is omitted from following lists and activity routes return 404 until refollow reattaches it to an account.",
436
437
  security: [{ bearerAuth: [] }],
437
438
  parameters: [{ name: "id", in: "path", required: true, schema: { type: "integer" } }],
438
439
  responses: {
@@ -768,6 +769,7 @@ export const openApiDocument = {
768
769
  get: {
769
770
  operationId: "following.list",
770
771
  summary: "List following records",
772
+ description: "Lists account-backed following records. Inactive history detached by contact deletion is internal and omitted; accountId remains required and non-null.",
771
773
  security: [{ bearerAuth: [] }],
772
774
  parameters: [
773
775
  {
@@ -797,6 +799,7 @@ export const openApiDocument = {
797
799
  post: {
798
800
  operationId: "following.create",
799
801
  summary: "Follow a target",
802
+ description: "Reuses an inactive following identity, including history detached by contact deletion, and attaches it to the uniquely resolved contact-owned account. Retained incoming snapshots, cursors and deduplication identities survive refollow.",
800
803
  security: [{ bearerAuth: [] }],
801
804
  requestBody: {
802
805
  required: true,
@@ -826,7 +829,7 @@ export const openApiDocument = {
826
829
  get: {
827
830
  operationId: "following.activity.list",
828
831
  summary: "Download buffered posts and boosts from one followed account",
829
- description: "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive deletion and remain usable when hasMore is false. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.",
832
+ description: "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive full copy deletion and remain usable when hasMore is false, even after the buffer empties. Redelivery after removal gets a new copy ID and a higher receipt position; client read history must use remote identities instead of copy IDs/cursors. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.",
830
833
  security: [{ bearerAuth: [] }],
831
834
  parameters: [
832
835
  { name: "id", in: "path", required: true, schema: { type: "integer", minimum: 1 } },
@@ -860,7 +863,7 @@ export const openApiDocument = {
860
863
  delete: {
861
864
  operationId: "following.activity.remove",
862
865
  summary: "Remove selected buffered website copies",
863
- description: "Atomic body removal in the selected followed account and configured actor only. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical requests after uncertain responses; removed may be zero. No read or persistence acknowledgment. Bodies are removed; minimal deduplication identities remain indefinitely.",
866
+ description: "Contract 3.0.0: atomically removes selected website copies, bodies and all delivery/deduplication metadata in the followed-account/configured-actor scope. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical copy IDs after uncertain responses; removed may be zero and old IDs cannot remove a newly redelivered copy. No read or persistence acknowledgment. After removal the same remote activity/object may return with a new copy ID and a higher receipt position. Clients own long-term read/redelivery recognition; deduplication lasts only while buffered.",
864
867
  security: [{ bearerAuth: [] }],
865
868
  parameters: [
866
869
  { name: "id", in: "path", required: true, schema: { type: "integer", minimum: 1 } },
@@ -878,7 +881,7 @@ export const openApiDocument = {
878
881
  },
879
882
  responses: {
880
883
  "200": {
881
- description: "Number of copies actually removed by this request; zero is a successful idempotent retry, not an error.",
884
+ description: "Number of copy metadata records actually removed, including selected legacy body-less records; zero is a successful idempotent retry, not an error.",
882
885
  content: {
883
886
  "application/json": {
884
887
  schema: { $ref: "#/components/schemas/RemoveIncomingActivityResponse" },
@@ -1723,7 +1726,7 @@ export const openApiDocument = {
1723
1726
  id: {
1724
1727
  type: "string",
1725
1728
  format: "uuid",
1726
- description: "Opaque buffered-copy identity, not an activity or original-object ID. Treat as opaque and use only for this followed account.",
1729
+ description: "Opaque buffered-copy identity, not a durable read-history key or remote activity/object ID. Use only for this actor/following scope. Redelivery after removal receives a new ID; recognize consumed posts by scoped kind/objectId.",
1727
1730
  },
1728
1731
  kind: { type: "string", const: "post" },
1729
1732
  activityId: { type: "string", format: "uri" },
@@ -1789,7 +1792,7 @@ export const openApiDocument = {
1789
1792
  },
1790
1793
  IncomingBoost: {
1791
1794
  type: "object",
1792
- description: "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original; retries of an observed ID never resurrect a removed copy. Existing post payloads are unchanged.",
1795
+ description: "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original. Repeats are suppressed only while buffered; after explicit removal the same Announce may return as a new copy. Existing post payloads are unchanged.",
1793
1796
  required: [
1794
1797
  "id",
1795
1798
  "kind",
@@ -1812,7 +1815,7 @@ export const openApiDocument = {
1812
1815
  id: {
1813
1816
  type: "string",
1814
1817
  format: "uuid",
1815
- description: "Opaque buffered-copy identity; not the Announce or original-object ID.",
1818
+ description: "Opaque buffered-copy identity; not the Announce, original-object ID or a durable read key. Redelivery after removal receives a new ID; recognize consumed boosts by scoped kind/activityId, not objectId.",
1816
1819
  },
1817
1820
  kind: { type: "string", const: "boost" },
1818
1821
  activityId: {
package/dist/openapi.json CHANGED
@@ -2,11 +2,11 @@
2
2
  "openapi": "3.1.0",
3
3
  "x-slugkit-contract": {
4
4
  "id": "slugkit-management-api",
5
- "version": "2.2.0"
5
+ "version": "3.0.0"
6
6
  },
7
7
  "info": {
8
8
  "title": "Slugkit API",
9
- "version": "2.2.0"
9
+ "version": "3.0.0"
10
10
  },
11
11
  "servers": [
12
12
  {
@@ -622,6 +622,7 @@
622
622
  "delete": {
623
623
  "operationId": "contacts.delete",
624
624
  "summary": "Delete a contact by ID",
625
+ "description": "Deletes the contact and its owned accounts after detaching inactive follow history. Pending or accepted follows and unrelated references return 409. Retained incoming snapshots and delivery identities are not deleted. Detached history is omitted from following lists and activity routes return 404 until refollow reattaches it to an account.",
625
626
  "security": [
626
627
  {
627
628
  "bearerAuth": []
@@ -1570,6 +1571,7 @@
1570
1571
  "get": {
1571
1572
  "operationId": "following.list",
1572
1573
  "summary": "List following records",
1574
+ "description": "Lists account-backed following records. Inactive history detached by contact deletion is internal and omitted; accountId remains required and non-null.",
1573
1575
  "security": [
1574
1576
  {
1575
1577
  "bearerAuth": []
@@ -1639,6 +1641,7 @@
1639
1641
  "post": {
1640
1642
  "operationId": "following.create",
1641
1643
  "summary": "Follow a target",
1644
+ "description": "Reuses an inactive following identity, including history detached by contact deletion, and attaches it to the uniquely resolved contact-owned account. Retained incoming snapshots, cursors and deduplication identities survive refollow.",
1642
1645
  "security": [
1643
1646
  {
1644
1647
  "bearerAuth": []
@@ -1712,7 +1715,7 @@
1712
1715
  "get": {
1713
1716
  "operationId": "following.activity.list",
1714
1717
  "summary": "Download buffered posts and boosts from one followed account",
1715
- "description": "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive deletion and remain usable when hasMore is false. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.",
1718
+ "description": "Non-consuming, actor-scoped delivery buffer of posts and boosts, without an opt-in filter. No read acknowledgment or deletion. Ordered by stable receipt sequence, not original publication time. Cursors survive full copy deletion and remain usable when hasMore is false, even after the buffer empties. Redelivery after removal gets a new copy ID and a higher receipt position; client read history must use remote identities instead of copy IDs/cursors. Handle each item's kind; boosts distinguish sharing from original-author attribution. See docs/specs/12-incoming-activity.md for delivery and retry semantics.",
1716
1719
  "security": [
1717
1720
  {
1718
1721
  "bearerAuth": []
@@ -1807,7 +1810,7 @@
1807
1810
  "delete": {
1808
1811
  "operationId": "following.activity.remove",
1809
1812
  "summary": "Remove selected buffered website copies",
1810
- "description": "Atomic body removal in the selected followed account and configured actor only. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical requests after uncertain responses; removed may be zero. No read or persistence acknowledgment. Bodies are removed; minimal deduplication identities remain indefinitely.",
1813
+ "description": "Contract 3.0.0: atomically removes selected website copies, bodies and all delivery/deduplication metadata in the followed-account/configured-actor scope. Does not remove remote originals, owned publications or client bodies. Missing/already-removed/out-of-scope IDs are harmless; duplicates are coalesced. Retry identical copy IDs after uncertain responses; removed may be zero and old IDs cannot remove a newly redelivered copy. No read or persistence acknowledgment. After removal the same remote activity/object may return with a new copy ID and a higher receipt position. Clients own long-term read/redelivery recognition; deduplication lasts only while buffered.",
1811
1814
  "security": [
1812
1815
  {
1813
1816
  "bearerAuth": []
@@ -1843,7 +1846,7 @@
1843
1846
  },
1844
1847
  "responses": {
1845
1848
  "200": {
1846
- "description": "Number of copies actually removed by this request; zero is a successful idempotent retry, not an error.",
1849
+ "description": "Number of copy metadata records actually removed, including selected legacy body-less records; zero is a successful idempotent retry, not an error.",
1847
1850
  "content": {
1848
1851
  "application/json": {
1849
1852
  "schema": {
@@ -3009,7 +3012,7 @@
3009
3012
  },
3010
3013
  "version": {
3011
3014
  "type": "string",
3012
- "const": "2.2.0"
3015
+ "const": "3.0.0"
3013
3016
  }
3014
3017
  }
3015
3018
  }
@@ -3976,7 +3979,7 @@
3976
3979
  "id": {
3977
3980
  "type": "string",
3978
3981
  "format": "uuid",
3979
- "description": "Opaque buffered-copy identity, not an activity or original-object ID. Treat as opaque and use only for this followed account."
3982
+ "description": "Opaque buffered-copy identity, not a durable read-history key or remote activity/object ID. Use only for this actor/following scope. Redelivery after removal receives a new ID; recognize consumed posts by scoped kind/objectId."
3980
3983
  },
3981
3984
  "kind": {
3982
3985
  "type": "string",
@@ -4109,7 +4112,7 @@
4109
4112
  },
4110
4113
  "IncomingBoost": {
4111
4114
  "type": "object",
4112
- "description": "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original; retries of an observed ID never resurrect a removed copy. Existing post payloads are unchanged.",
4115
+ "description": "One newly delivered boost of a remote post, including older originals. The followed sharing account is distinct from the original author. Resolve the referenced canonical original, not posting history. Distinct Announce activity IDs are distinct copies even for the same original. Repeats are suppressed only while buffered; after explicit removal the same Announce may return as a new copy. Existing post payloads are unchanged.",
4113
4116
  "required": [
4114
4117
  "id",
4115
4118
  "kind",
@@ -4132,7 +4135,7 @@
4132
4135
  "id": {
4133
4136
  "type": "string",
4134
4137
  "format": "uuid",
4135
- "description": "Opaque buffered-copy identity; not the Announce or original-object ID."
4138
+ "description": "Opaque buffered-copy identity; not the Announce, original-object ID or a durable read key. Redelivery after removal receives a new ID; recognize consumed boosts by scoped kind/activityId, not objectId."
4136
4139
  },
4137
4140
  "kind": {
4138
4141
  "type": "string",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@evcraddock/slug-api",
3
- "version": "1.0.0",
3
+ "version": "2.0.0",
4
4
  "description": "Reusable Hono helpers for Slugkit-compatible management APIs.",
5
5
  "license": "MIT",
6
6
  "private": false,