@homespunapps/core 1.5.1 → 1.6.0

package/dist/client.d.ts

@@ -400,6 +400,22 @@ export declare class HomespunClient {
      * be removed — the relay refuses with a 409 conflict.
      */
     removeAppMember(appId: string, humanId: string): Promise<void>;
+    /**
+     * GET /v1/apps/:id/collections/:name/retention returns the collection's
+     * effective retention (the bounds in force), the author default, the raw owner
+     * override, and how many live rows those bounds would prune on the next sweep.
+     */
+    getCollectionRetention(appId: string, collection: string): Promise<CollectionRetentionView>;
+    /**
+     * PATCH /v1/apps/:id/collections/:name/retention sets or clears the owner
+     * retention override, per axis. A number sets that axis's override; `null`
+     * clears it (reverts to the author default); omit an axis to leave it
+     * unchanged. Returns the new effective retention plus the would-prune count.
+     */
+    setCollectionRetention(appId: string, collection: string, override: {
+        maxRows?: number | null;
+        maxAgeDays?: number | null;
+    }): Promise<CollectionRetentionView>;
     /**
      * GET /v1/apps/:id/ingest-hooks lists the app's inbound catch-hooks with the
      * full secret URL (decrypted server-side), the current rule metadata
@@ -825,6 +841,23 @@ export interface AppMember {
  * handshake) are null when the hook's rule has left the manifest (disabledAt
  * set). `deliveries` are per-status counts of the hook's inbound journal.
  */
+/** One retention axis pair, either bound null when unset. */
+export interface RetentionAxes {
+    maxRows: number | null;
+    maxAgeDays: number | null;
+}
+/**
+ * A collection's retention picture (issue #956): the EFFECTIVE bounds in force
+ * (per-axis `override ?? authorDefault`), the AUTHOR default declared in the
+ * manifest, the raw owner OVERRIDE, and `wouldPrune`, how many live rows the
+ * effective bounds would prune on the next sweep.
+ */
+export interface CollectionRetentionView {
+    effective: RetentionAxes;
+    authorDefault: RetentionAxes;
+    override: RetentionAxes;
+    wouldPrune: number;
+}
 export interface IngestHookInfo {
     name: string;
     url: string;

package/dist/client.js

@@ -747,6 +747,36 @@ export class HomespunClient {
             this.fail(r);
     }
     // -------------------------------------------------------------------------
+    // Collection retention override (issue #956). The author declares default
+    // retention in the manifest; this lets the OWNER tighten or loosen it per
+    // collection at runtime, without a redeploy. Effective retention is per-axis
+    // `override ?? authorDefault`; clearing an axis (null) reverts it to the
+    // author default.
+    // -------------------------------------------------------------------------
+    /**
+     * GET /v1/apps/:id/collections/:name/retention returns the collection's
+     * effective retention (the bounds in force), the author default, the raw owner
+     * override, and how many live rows those bounds would prune on the next sweep.
+     */
+    async getCollectionRetention(appId, collection) {
+        const r = await this.call("GET", `/v1/apps/${encodeURIComponent(appId)}/collections/${encodeURIComponent(collection)}/retention`);
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
+    /**
+     * PATCH /v1/apps/:id/collections/:name/retention sets or clears the owner
+     * retention override, per axis. A number sets that axis's override; `null`
+     * clears it (reverts to the author default); omit an axis to leave it
+     * unchanged. Returns the new effective retention plus the would-prune count.
+     */
+    async setCollectionRetention(appId, collection, override) {
+        const r = await this.call("PATCH", `/v1/apps/${encodeURIComponent(appId)}/collections/${encodeURIComponent(collection)}/retention`, override);
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
+    // -------------------------------------------------------------------------
     // Inbound catch-hooks (inbound-webhooks PR 3). Read + rotate the smallest
     // surface an agent needs: list an app's declared hooks with their full secret
     // URL (so the agent can tell its owner the exact URL to paste into an external

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { HomespunClient, HomespunApiError } from "./client.js";
-export type { ClientOptions, RelayResponse, AttachmentRef, UploadBlobOptions, PresignBlobOptions, AttachmentTokenMintResponse, ListBlobsOptions, AttachmentTokenAuditEntry, AttachmentTokenListResponse, QueryResponse, AppAsset, DeployAppRequest, DeployAppResponse, RedeployAppRequest, RedeployAppResponse, DeployCheckRequest, DeployCheckResult, KeyMintResult, AppSummary, AppDetail, AppsPage, AppDomain, AppDomainDnsRecord, AppMember, AddAppMemberResult, AppRow, AppRowsPage, ListScalar, ListWhereCondition, ListSortSpec, BatchRowInput, BatchRowResult, BatchResult, BatchWriteOptions, AppFeedEntry, AppFeedPage, CommunitySetupStep, } from "./client.js";
+export type { ClientOptions, RelayResponse, AttachmentRef, UploadBlobOptions, PresignBlobOptions, AttachmentTokenMintResponse, ListBlobsOptions, AttachmentTokenAuditEntry, AttachmentTokenListResponse, QueryResponse, AppAsset, DeployAppRequest, DeployAppResponse, RedeployAppRequest, RedeployAppResponse, DeployCheckRequest, DeployCheckResult, KeyMintResult, AppSummary, AppDetail, AppsPage, AppDomain, AppDomainDnsRecord, AppMember, AddAppMemberResult, AppRow, AppRowsPage, ListScalar, ListWhereCondition, ListSortSpec, BatchRowInput, BatchRowResult, BatchResult, BatchWriteOptions, AppFeedEntry, AppFeedPage, CommunitySetupStep, RetentionAxes, CollectionRetentionView, } from "./client.js";
 export { openStream } from "./stream.js";
 export type { OpenStreamOptions, StreamHandlers, StreamHandle, } from "./stream.js";
 export { openAppStream, appWsUrlFromAppUrl } from "./app-stream.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/core",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Homespun relay client: typed HTTP + WebSocket operations against a Homespun relay. Framework-free.",
   "license": "MIT",
   "type": "module",