@evcraddock/slug-api 1.0.0 → 1.1.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 +8 -2
- package/dist/contract.d.ts +1 -1
- package/dist/contract.js +1 -1
- package/dist/contract.json +3 -3
- package/dist/openapi.d.ts +6 -3
- package/dist/openapi.js +3 -0
- package/dist/openapi.json +6 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -20,11 +20,17 @@ 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
|
+
## Contact deletion contract 2.3.0
|
|
24
|
+
|
|
25
|
+
Package **1.1.0** carries compatible contract **2.3.0**, adding 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.
|
|
26
|
+
|
|
27
|
+
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). Update with `npm install --save-exact @evcraddock/slug-api@1.1.0` and adopt the site-owned implementation. Package publication does not deploy websites; migration execution, site deployment and production contact cleanup remain separately authorized.
|
|
28
|
+
|
|
23
29
|
## Incoming activity contract 2.2.0
|
|
24
30
|
|
|
25
|
-
|
|
31
|
+
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
32
|
|
|
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.
|
|
33
|
+
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
34
|
|
|
29
35
|
## Version and release policy
|
|
30
36
|
|
package/dist/contract.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export declare const SLUGKIT_CONTRACT_ID = "slugkit-management-api";
|
|
2
|
-
export declare const SLUGKIT_CONTRACT_VERSION = "2.
|
|
2
|
+
export declare const SLUGKIT_CONTRACT_VERSION = "2.3.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
|
+
export const SLUGKIT_CONTRACT_VERSION = "2.3.0";
|
package/dist/contract.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "slugkit-management-api",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.3.0",
|
|
4
4
|
"packageName": "@evcraddock/slug-api",
|
|
5
|
-
"packageVersion": "1.
|
|
5
|
+
"packageVersion": "1.1.0",
|
|
6
6
|
"artifact": "openapi.json",
|
|
7
|
-
"sha256": "
|
|
7
|
+
"sha256": "4c46d091f6e92e6f58af92d066e1811a69b382f6e9f3b560bdd64559e84973ac",
|
|
8
8
|
"changeType": "additive"
|
|
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.
|
|
5
|
+
readonly version: "2.3.0";
|
|
6
6
|
};
|
|
7
7
|
readonly info: {
|
|
8
8
|
readonly title: "Slugkit API";
|
|
9
|
-
readonly version: "2.
|
|
9
|
+
readonly version: "2.3.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
|
}];
|
|
@@ -2788,7 +2791,7 @@ export declare const openApiDocument: {
|
|
|
2788
2791
|
};
|
|
2789
2792
|
readonly version: {
|
|
2790
2793
|
readonly type: "string";
|
|
2791
|
-
readonly const: "2.
|
|
2794
|
+
readonly const: "2.3.0";
|
|
2792
2795
|
};
|
|
2793
2796
|
};
|
|
2794
2797
|
};
|
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,
|
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.
|
|
5
|
+
"version": "2.3.0"
|
|
6
6
|
},
|
|
7
7
|
"info": {
|
|
8
8
|
"title": "Slugkit API",
|
|
9
|
-
"version": "2.
|
|
9
|
+
"version": "2.3.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": []
|
|
@@ -3009,7 +3012,7 @@
|
|
|
3009
3012
|
},
|
|
3010
3013
|
"version": {
|
|
3011
3014
|
"type": "string",
|
|
3012
|
-
"const": "2.
|
|
3015
|
+
"const": "2.3.0"
|
|
3013
3016
|
}
|
|
3014
3017
|
}
|
|
3015
3018
|
}
|