@fusebase/fusebase-gate-sdk 2.7.0 → 2.7.1-sdk.1

package/dist/apis/PaperclipServicesApi.d.ts

@@ -0,0 +1,124 @@
+/**
+ * PaperclipServices API
+ *
+ * Generated from contract introspection
+ * Domain: paperclip-services
+ */
+import type { Client } from "../runtime/transport";
+import type { orgIdInPathRequired, PaperclipServiceAppKeyInPathRequired, PaperclipServiceBackupRequestContract, PaperclipServiceInstallRequestContract, PaperclipServiceInstallResultContract, PaperclipServiceOperationContract, PaperclipServiceOperationIdInPathRequired, PaperclipServiceOperationRequestContract, PaperclipServiceRestoreRequestContract, PaperclipServiceRetryRequestContract, PaperclipServicesCapabilitiesContract, PaperclipServicesCapacityContract, PaperclipServicesHealthContract, PaperclipServiceUpgradeRequestContract } from "../types";
+export declare class PaperclipServicesApi {
+    private client;
+    constructor(client: Client);
+    /**
+     * Back up a Paperclip Service
+     * Starts an idempotent retained backup operation.
+     */
+    backupPaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            appKey: PaperclipServiceAppKeyInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceBackupRequestContract;
+    }): Promise<PaperclipServiceOperationContract>;
+    /**
+     * Delete a Paperclip Service
+     * Starts an idempotent Nimbus-backed deletion operation for an installed service.
+     */
+    deletePaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            appKey: PaperclipServiceAppKeyInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceOperationRequestContract;
+    }): Promise<PaperclipServiceOperationContract>;
+    /**
+     * Get a Paperclip Service operation
+     * Returns the durable Nimbus lifecycle operation state.
+     */
+    getPaperclipServiceOperation(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            operationId: PaperclipServiceOperationIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+    }): Promise<PaperclipServiceOperationContract>;
+    /**
+     * Get Paperclip Services capabilities
+     * Returns Nimbus-backed service availability and entitlement for an org-scoped Paperclip service token.
+     */
+    getPaperclipServicesCapabilities(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+    }): Promise<PaperclipServicesCapabilitiesContract>;
+    /**
+     * Get Paperclip Services capacity
+     * Returns reserved, used, and available service capacity for the token-scoped organization.
+     */
+    getPaperclipServicesCapacity(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+    }): Promise<PaperclipServicesCapacityContract>;
+    /**
+     * Get Paperclip Services health
+     * Returns observed workloads, alerts, and reconciliation state for the token-scoped organization.
+     */
+    getPaperclipServicesHealth(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+    }): Promise<PaperclipServicesHealthContract>;
+    /**
+     * Install a Paperclip Service
+     * Starts an idempotent Nimbus-backed installation operation for the token-scoped organization.
+     */
+    installPaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceInstallRequestContract;
+    }): Promise<PaperclipServiceInstallResultContract>;
+    /**
+     * Restore a Paperclip Service
+     * Starts an idempotent restore from a verified retained backup.
+     */
+    restorePaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            appKey: PaperclipServiceAppKeyInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceRestoreRequestContract;
+    }): Promise<PaperclipServiceOperationContract>;
+    /**
+     * Retry a Paperclip Service operation
+     * Starts an idempotent retry for the requested lifecycle action.
+     */
+    retryPaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            appKey: PaperclipServiceAppKeyInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceRetryRequestContract;
+    }): Promise<PaperclipServiceOperationContract>;
+    /**
+     * Upgrade a Paperclip Service
+     * Starts an idempotent upgrade to an approved manifest revision.
+     */
+    upgradePaperclipService(params: {
+        path: {
+            orgId: orgIdInPathRequired;
+            appKey: PaperclipServiceAppKeyInPathRequired;
+        };
+        headers?: Record<string, string>;
+        body: PaperclipServiceUpgradeRequestContract;
+    }): Promise<PaperclipServiceOperationContract>;
+}

package/dist/apis/PaperclipServicesApi.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * PaperclipServices API
+ *
+ * Generated from contract introspection
+ * Domain: paperclip-services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaperclipServicesApi = void 0;
+class PaperclipServicesApi {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Back up a Paperclip Service
+     * Starts an idempotent retained backup operation.
+     */
+    async backupPaperclipService(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/paperclip-services/installations/:appKey/backup",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "backupPaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Delete a Paperclip Service
+     * Starts an idempotent Nimbus-backed deletion operation for an installed service.
+     */
+    async deletePaperclipService(params) {
+        return this.client.request({
+            method: "DELETE",
+            path: "/:orgId/paperclip-services/installations/:appKey",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "deletePaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Get a Paperclip Service operation
+     * Returns the durable Nimbus lifecycle operation state.
+     */
+    async getPaperclipServiceOperation(params) {
+        return this.client.request({
+            method: "GET",
+            path: "/:orgId/paperclip-services/operations/:operationId",
+            pathParams: params.path,
+            headers: params.headers,
+            opId: "getPaperclipServiceOperation",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Get Paperclip Services capabilities
+     * Returns Nimbus-backed service availability and entitlement for an org-scoped Paperclip service token.
+     */
+    async getPaperclipServicesCapabilities(params) {
+        return this.client.request({
+            method: "GET",
+            path: "/:orgId/paperclip-services/capabilities",
+            pathParams: params.path,
+            headers: params.headers,
+            opId: "getPaperclipServicesCapabilities",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Get Paperclip Services capacity
+     * Returns reserved, used, and available service capacity for the token-scoped organization.
+     */
+    async getPaperclipServicesCapacity(params) {
+        return this.client.request({
+            method: "GET",
+            path: "/:orgId/paperclip-services/capacity",
+            pathParams: params.path,
+            headers: params.headers,
+            opId: "getPaperclipServicesCapacity",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Get Paperclip Services health
+     * Returns observed workloads, alerts, and reconciliation state for the token-scoped organization.
+     */
+    async getPaperclipServicesHealth(params) {
+        return this.client.request({
+            method: "GET",
+            path: "/:orgId/paperclip-services/health",
+            pathParams: params.path,
+            headers: params.headers,
+            opId: "getPaperclipServicesHealth",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Install a Paperclip Service
+     * Starts an idempotent Nimbus-backed installation operation for the token-scoped organization.
+     */
+    async installPaperclipService(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/paperclip-services/installations",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "installPaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Restore a Paperclip Service
+     * Starts an idempotent restore from a verified retained backup.
+     */
+    async restorePaperclipService(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/paperclip-services/installations/:appKey/restore",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "restorePaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Retry a Paperclip Service operation
+     * Starts an idempotent retry for the requested lifecycle action.
+     */
+    async retryPaperclipService(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/paperclip-services/installations/:appKey/retry",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "retryPaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+    /**
+     * Upgrade a Paperclip Service
+     * Starts an idempotent upgrade to an approved manifest revision.
+     */
+    async upgradePaperclipService(params) {
+        return this.client.request({
+            method: "POST",
+            path: "/:orgId/paperclip-services/installations/:appKey/upgrade",
+            pathParams: params.path,
+            headers: params.headers,
+            body: params.body,
+            opId: "upgradePaperclipService",
+            expectedContentType: "application/json",
+        });
+    }
+}
+exports.PaperclipServicesApi = PaperclipServicesApi;

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export { NotesApi } from "./apis/NotesApi";
 export { OrgGroupsApi } from "./apis/OrgGroupsApi";
 export { OrgUsersApi } from "./apis/OrgUsersApi";
 export { OrgsApi } from "./apis/OrgsApi";
+export { PaperclipServicesApi } from "./apis/PaperclipServicesApi";
 export { PortalFeatureContextApi } from "./apis/PortalFeatureContextApi";
 export { PortalsApi } from "./apis/PortalsApi";
 export { SystemApi } from "./apis/SystemApi";

package/dist/index.js

@@ -19,7 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkspacesApi = exports.TokensApi = exports.SystemApi = exports.PortalsApi = exports.PortalFeatureContextApi = exports.OrgsApi = exports.OrgUsersApi = exports.OrgGroupsApi = exports.NotesApi = exports.McpManagerApi = exports.IsolatedStoresApi = exports.HealthApi = exports.FusebaseAuthApi = exports.FilesApi = exports.EmailsApi = exports.BillingApi = exports.AppMagicLinksApi = exports.AppEmbedTargetsApi = exports.AppApisApi = exports.AccessApi = void 0;
+exports.WorkspacesApi = exports.TokensApi = exports.SystemApi = exports.PortalsApi = exports.PortalFeatureContextApi = exports.PaperclipServicesApi = exports.OrgsApi = exports.OrgUsersApi = exports.OrgGroupsApi = exports.NotesApi = exports.McpManagerApi = exports.IsolatedStoresApi = exports.HealthApi = exports.FusebaseAuthApi = exports.FilesApi = exports.EmailsApi = exports.BillingApi = exports.AppMagicLinksApi = exports.AppEmbedTargetsApi = exports.AppApisApi = exports.AccessApi = void 0;
 __exportStar(require("./runtime"), exports);
 __exportStar(require("./types"), exports);
 var AccessApi_1 = require("./apis/AccessApi");
@@ -52,6 +52,8 @@ var OrgUsersApi_1 = require("./apis/OrgUsersApi");
 Object.defineProperty(exports, "OrgUsersApi", { enumerable: true, get: function () { return OrgUsersApi_1.OrgUsersApi; } });
 var OrgsApi_1 = require("./apis/OrgsApi");
 Object.defineProperty(exports, "OrgsApi", { enumerable: true, get: function () { return OrgsApi_1.OrgsApi; } });
+var PaperclipServicesApi_1 = require("./apis/PaperclipServicesApi");
+Object.defineProperty(exports, "PaperclipServicesApi", { enumerable: true, get: function () { return PaperclipServicesApi_1.PaperclipServicesApi; } });
 var PortalFeatureContextApi_1 = require("./apis/PortalFeatureContextApi");
 Object.defineProperty(exports, "PortalFeatureContextApi", { enumerable: true, get: function () { return PortalFeatureContextApi_1.PortalFeatureContextApi; } });
 var PortalsApi_1 = require("./apis/PortalsApi");

package/dist/types/index.d.ts

@@ -20,6 +20,7 @@ export * from "./note/note";
 export * from "./org-group/org-group";
 export type { ClientAccountScheduledDeletionRequestContract, ClientAccountScheduledDeletionResponseContract, CreateWorkspaceRequestContract, OrgInviteContract, OrgMagicLinkContract, OrgMemberExpectedJoinedAfterInQueryOptional, OrgMemberExpectedRoleInQueryOptional, OrgMemberRemoveResponseContract, OrgPortalContract, OrgPortalListResponseContract, OrgUserAddRequestContract, OrgUserAddResponseContract, OrgUserContract, OrgUserIdInPathRequired, OrgUserListResponseContract, OrgUserWorkspaceIdInPathRequired, OrgWorkspaceContract, OrgWorkspaceInviteContract, OrgWorkspaceListResponseContract, OrgWorkspaceMemberContract, OrgWorkspaceMemberListResponseContract, WorkspaceMemberRemoveResponseContract } from "./org-user/org-user";
 export * from "./orgs/orgs";
+export * from "./paperclip-services/paperclip-services";
 export type { VerifyPortalFeatureContextTokenRequestContract, VerifyPortalFeatureContextTokenResponseContract } from "./portal-feature-context/portal-feature-context";
 export * from "./portals/portals";
 export * from "./shared/common";

package/dist/types/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./mcp-manager/mcp-manager"), exports);
 __exportStar(require("./note/note"), exports);
 __exportStar(require("./org-group/org-group"), exports);
 __exportStar(require("./orgs/orgs"), exports);
+__exportStar(require("./paperclip-services/paperclip-services"), exports);
 __exportStar(require("./portals/portals"), exports);
 __exportStar(require("./shared/common"), exports);
 __exportStar(require("./shared/enums"), exports);

package/dist/types/paperclip-services/paperclip-services.d.ts

@@ -0,0 +1,142 @@
+export type PaperclipServicesEntitlementSourceContract = "advanced_subscription" | "ltd_coupons" | "ineligible";
+export type PaperclipServicesEntitlementErrorCodeContract = "ltd_coupons_below_minimum" | "ineligible" | "unavailable";
+export interface PaperclipServicesEntitlementContract {
+    eligible: boolean;
+    source: PaperclipServicesEntitlementSourceContract;
+    couponCount: number | null;
+    evaluatedAt: string;
+    errorCode?: PaperclipServicesEntitlementErrorCodeContract;
+    message?: string;
+}
+export interface PaperclipServicesCapabilitiesContract {
+    provider: string;
+    providerVersion: string;
+    architecture: string;
+    featureAvailable: boolean;
+    entitlement?: PaperclipServicesEntitlementContract;
+}
+export interface PaperclipServicesResourceUsageContract {
+    cpu: string;
+    memory: string;
+    storage: string;
+    pods: number;
+    persistentVolumeClaims: number;
+}
+export interface PaperclipServicesCapacityContract {
+    currentProfile: string;
+    reserved: PaperclipServicesResourceUsageContract;
+    used: PaperclipServicesResourceUsageContract;
+    available: PaperclipServicesResourceUsageContract;
+    eligibleNextProfiles: string[];
+}
+export type PaperclipServicesComponentKindContract = "Deployment" | "StatefulSet";
+export type PaperclipServicesComponentStatusContract = "healthy" | "degraded" | "unhealthy" | "unknown";
+export interface PaperclipServicesComponentHealthContract {
+    appKey: string;
+    component: string;
+    kind: PaperclipServicesComponentKindContract;
+    status: PaperclipServicesComponentStatusContract;
+    desiredReplicas: number;
+    readyReplicas: number;
+    restartCount: number;
+    manifestRevision?: string;
+    reason?: string;
+}
+export interface PaperclipServicesHealthAlertContract {
+    code: string;
+    severity: "warning" | "critical";
+    message: string;
+    appKey?: string;
+    component?: string;
+}
+export interface PaperclipServicesHealthContract {
+    status: "healthy" | "degraded" | "unavailable";
+    checkedAt: string;
+    components: PaperclipServicesComponentHealthContract[];
+    alerts: PaperclipServicesHealthAlertContract[];
+    operations: {
+        pending: number;
+        running: number;
+        staleClaims: number;
+        needsManualReview: number;
+    };
+    reconciliation: {
+        orphanedWorkloads: number;
+        outdatedManifests: number;
+    };
+}
+export type PaperclipServiceAppKeyContract = "n8n" | "firecrawl";
+export type PaperclipServiceAppKeyInPathRequired = string;
+export type PaperclipServiceOperationIdInPathRequired = string;
+export interface PaperclipServiceOperationRequestContract {
+    orgRuntimeIdentity: string;
+    managedCompanyId: string;
+    operationId: string;
+    idempotencyKey: string;
+    providerRef?: string;
+}
+export interface PaperclipServiceInstallRequestContract extends PaperclipServiceOperationRequestContract {
+    appKey: PaperclipServiceAppKeyContract;
+    approvedManifestRevision: string;
+}
+export interface PaperclipServiceUpgradeRequestContract extends PaperclipServiceOperationRequestContract {
+    appKey: PaperclipServiceAppKeyContract;
+    approvedManifestRevision: string;
+}
+export interface PaperclipServiceBackupRequestContract extends PaperclipServiceOperationRequestContract {
+    manifestRevision: string;
+}
+export interface PaperclipServiceRestoreRequestContract extends PaperclipServiceOperationRequestContract {
+    backupProviderRequestId: string;
+}
+export interface PaperclipServiceRetryRequestContract extends PaperclipServiceOperationRequestContract {
+    action: "install" | "delete" | "upgrade" | "backup" | "restore";
+}
+export type PaperclipServiceOperationStatusContract = "pending" | "running" | "succeeded" | "failed" | "needs_manual_review";
+export interface PaperclipServiceOperationContract {
+    providerRequestId: string;
+    status: PaperclipServiceOperationStatusContract;
+    providerRef?: string;
+    providerRouteRef?: string;
+    observedState: Record<string, unknown>;
+    error?: string;
+}
+export interface PaperclipServiceInstallResultContract {
+    outcome: "accepted" | "insufficient_capacity";
+    operation?: PaperclipServiceOperationContract;
+    requested?: PaperclipServicesResourceUsageContract;
+    available?: PaperclipServicesResourceUsageContract;
+    requiredProfile?: string;
+    eligibleProfiles?: string[];
+}
+export declare const PaperclipServicesEntitlementSourceContract: {
+    readonly AdvancedSubscription: "advanced_subscription";
+    readonly LtdCoupons: "ltd_coupons";
+    readonly Ineligible: "ineligible";
+};
+export declare const PaperclipServicesEntitlementErrorCodeContract: {
+    readonly LtdCouponsBelowMinimum: "ltd_coupons_below_minimum";
+    readonly Ineligible: "ineligible";
+    readonly Unavailable: "unavailable";
+};
+export declare const PaperclipServicesComponentKindContract: {
+    readonly Deployment: "Deployment";
+    readonly Statefulset: "StatefulSet";
+};
+export declare const PaperclipServicesComponentStatusContract: {
+    readonly Healthy: "healthy";
+    readonly Degraded: "degraded";
+    readonly Unhealthy: "unhealthy";
+    readonly Unknown: "unknown";
+};
+export declare const PaperclipServiceAppKeyContract: {
+    readonly N8n: "n8n";
+    readonly Firecrawl: "firecrawl";
+};
+export declare const PaperclipServiceOperationStatusContract: {
+    readonly Pending: "pending";
+    readonly Running: "running";
+    readonly Succeeded: "succeeded";
+    readonly Failed: "failed";
+    readonly NeedsManualReview: "needs_manual_review";
+};

package/dist/types/paperclip-services/paperclip-services.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaperclipServiceOperationStatusContract = exports.PaperclipServiceAppKeyContract = exports.PaperclipServicesComponentStatusContract = exports.PaperclipServicesComponentKindContract = exports.PaperclipServicesEntitlementErrorCodeContract = exports.PaperclipServicesEntitlementSourceContract = void 0;
+exports.PaperclipServicesEntitlementSourceContract = {
+    AdvancedSubscription: "advanced_subscription",
+    LtdCoupons: "ltd_coupons",
+    Ineligible: "ineligible"
+};
+exports.PaperclipServicesEntitlementErrorCodeContract = {
+    LtdCouponsBelowMinimum: "ltd_coupons_below_minimum",
+    Ineligible: "ineligible",
+    Unavailable: "unavailable"
+};
+exports.PaperclipServicesComponentKindContract = {
+    Deployment: "Deployment",
+    Statefulset: "StatefulSet"
+};
+exports.PaperclipServicesComponentStatusContract = {
+    Healthy: "healthy",
+    Degraded: "degraded",
+    Unhealthy: "unhealthy",
+    Unknown: "unknown"
+};
+exports.PaperclipServiceAppKeyContract = {
+    N8n: "n8n",
+    Firecrawl: "firecrawl"
+};
+exports.PaperclipServiceOperationStatusContract = {
+    Pending: "pending",
+    Running: "running",
+    Succeeded: "succeeded",
+    Failed: "failed",
+    NeedsManualReview: "needs_manual_review"
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusebase/fusebase-gate-sdk",
-  "version": "2.7.0",
+  "version": "2.7.1-sdk.1",
   "description": "TypeScript SDK for Fusebase Gate APIs - Generated from contract introspection",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/release-notes/2.7.1-sdk.1.md

@@ -0,0 +1,9 @@
+# Release Notes 2.7.1-sdk.1
+
+- Current ref: `HEAD`
+- Previous tag: `v2.7.1-sdk.1`
+- Generated at: 2026-08-17T11:49:27.978Z
+
+## Included Drafts
+
+- None

package/release-notes/latest.md

@@ -1,8 +1,8 @@
-# Release Notes 2.7.0
+# Release Notes 2.7.1-sdk.1
 
 - Current ref: `HEAD`
-- Previous tag: `v2.7.0`
-- Generated at: 2026-08-14T09:52:28.603Z
+- Previous tag: `v2.7.1-sdk.1`
+- Generated at: 2026-08-17T11:49:27.978Z
 
 ## Included Drafts
 

package/release-notes/2.6.4.md

@@ -1,62 +0,0 @@
-# Release Notes 2.6.4
-
-- Current ref: `HEAD`
-- Previous tag: `v2.6.1`
-- Generated at: 2026-08-14T09:49:04.731Z
-
-## Included Drafts
-
-- `docs/release-notes/2026-08-11-portal-service-id-format.md` - Portal homepage and duplicated items are addressable again (NIM-43233)
-- `docs/release-notes/2026-08-12-mcp-nullable-fields.md` - Summary
-- `docs/release-notes/2026-08-12-portal-page-initial-content.md` - Summary
-- `docs/release-notes/2026-08-14-mcp-json-schema-2020-12.md` - Summary
-
-## Summary
-
-### Portal homepage and duplicated items are addressable again (NIM-43233)
-
-Blocks could not be added to a portal's homepage: `listPortalContent` returned a `pageId` for the `home` item that every block operation answered `404` for, and there was no other id that worked. The gate was minting portal-service ids with `crypto.randomUUID()` (36 characters), but every portal-service `globalId` column is `VARCHAR(25)`. MySQL truncated the value on write without an error, so the row was stored under the first 25 characters while the id the gate returned — and, for the homepage, the one the home menu item's JSON attributes kept — stayed the full UUID.
-
-The gate now mints these ids in portal-service's own format: base36 of a v4 UUID, at most 25 characters, exactly what its `@lib/uuid` produces. It also truncates any over-long `pageId` it reads back out of a menu item, which repairs the portals already created with a broken one.
-
-
-## API / SDK Changes
-
-### Portal homepage and duplicated items are addressable again (NIM-43233)
-
-No contract change. Three ids change shape in responses, from a 36-character UUID to a 25-character lowercase alphanumeric string:
-
-- `createPortal` — the homepage `pageId` (visible via `listPortalContent`).
-- `duplicatePortalItem` — the returned `itemId`.
-- `addPortalNoteBlock` — the returned `blockId`.
-
-This is the same shape every other portal id already has; no schema declared these as UUIDs.
-
-
-## Consumer Impact
-
-### Portal homepage and duplicated items are addressable again (NIM-43233)
-
-The homepage is now reachable through the documented route: resolve its `pageId` from `listPortalContent` (menu item `type: "home"`) and call the normal semantic block operations, exactly as for any other page. `duplicatePortalItem` and `addPortalNoteBlock` now return ids that address the row they created.
-
-A consumer that pattern-matched the UUID shape of these three ids should stop — portal ids are opaque, and the op schemas already state that portal globalIds are not UUIDs.
-
-**Portals created before this fix are repaired too, with no data migration.** Their menu items still store the untruncated id, so the gate now truncates any `pageId` it reads back from portal-service to 25 characters. MySQL's truncation was deterministic, so that is exactly the id the page row was stored under, and the homepage becomes addressable on existing portals as well as new ones. On prod this covers 98 affected menu items across 25 portals.
-
-**No portal-service change.**
-
-
-## Verification
-
-### Portal homepage and duplicated items are addressable again (NIM-43233)
-
-- `npm test` — 1300 passed, 125 suites.
-- Reverting the id format reds tests across `tests/unit/portal-service-id.test.ts` and `tests/unit/portals-controller.test.ts`; neutralising the read-side truncation reds `tests/unit/portal-service-client.test.ts`.
-- `npm run build`, `npm run lint`.
-
-
-## Follow-ups
-
-### Portal homepage and duplicated items are addressable again (NIM-43233)
-
-- portal-service silently truncates any over-long `globalId`; a length guard there would turn a future occurrence of this class of bug into a `400` instead of corrupt data.

package/release-notes/2.7.0.md

@@ -1,9 +0,0 @@
-# Release Notes 2.7.0
-
-- Current ref: `HEAD`
-- Previous tag: `v2.7.0`
-- Generated at: 2026-08-14T09:52:28.603Z
-
-## Included Drafts
-
-- None