@orthacms/content-server 0.0.0-reserve.0

package/dist/lib/insights/http/controllers/content-pipeline.controller.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentPipelineController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+/**
+ * `GET /api/insights/content/pipeline` — the draft/published split for every
+ * content type that has at least one entry in the workspace.
+ *
+ * Takes no `?days=`: this is a snapshot of what exists now, not a flow over
+ * time. Filtering it by a window would answer a different and much less useful
+ * question ("what was created recently") under the same name.
+ */
+let ContentPipelineController = class ContentPipelineController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    pipeline(workspaceId) {
+        return this.insights.pipeline(workspaceId);
+    }
+};
+exports.ContentPipelineController = ContentPipelineController;
+tslib_1.__decorate([
+    (0, common_1.Get)('pipeline'),
+    tslib_1.__param(0, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentPipelineController.prototype, "pipeline", null);
+exports.ContentPipelineController = ContentPipelineController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentPipelineController);

package/dist/lib/insights/http/controllers/content-punchcard.controller.d.ts

@@ -0,0 +1,18 @@
+import { ContentInsightsQuery } from '../../infrastructure/queries/content-insights.query';
+import type { ContentPunchcardView } from '../../types/content-insights-view';
+import { InsightsRangeQueryDto } from '../dto/insights-range-query.dto';
+/**
+ * `GET /api/insights/content/punchcard` — editing activity by weekday and hour.
+ *
+ * Reads `content_entry_revisions` rather than the activity log: a revision is
+ * written on every save and carries a `workspace_id`, whereas `activity_events`
+ * is a global table with no workspace column, so a workspace-scoped answer
+ * simply isn't available from it. Saves are also the better signal — they cover
+ * the editing work, not only the moments something went live.
+ */
+export declare class ContentPunchcardController {
+    private readonly insights;
+    constructor(insights: ContentInsightsQuery);
+    punchcard(query: InsightsRangeQueryDto, workspaceId: string): Promise<ContentPunchcardView>;
+}
+//# sourceMappingURL=content-punchcard.controller.d.ts.map

package/dist/lib/insights/http/controllers/content-punchcard.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-punchcard.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/controllers/content-punchcard.controller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAEH,qBAAqB,EACxB,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAGa,0BAA0B;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAG3D,SAAS,CACI,KAAK,EAAE,qBAAqB,EACjB,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,oBAAoB,CAAC;CAMnC"}

package/dist/lib/insights/http/controllers/content-punchcard.controller.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentPunchcardController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+const insights_range_query_dto_1 = require("../dto/insights-range-query.dto");
+/**
+ * `GET /api/insights/content/punchcard` — editing activity by weekday and hour.
+ *
+ * Reads `content_entry_revisions` rather than the activity log: a revision is
+ * written on every save and carries a `workspace_id`, whereas `activity_events`
+ * is a global table with no workspace column, so a workspace-scoped answer
+ * simply isn't available from it. Saves are also the better signal — they cover
+ * the editing work, not only the moments something went live.
+ */
+let ContentPunchcardController = class ContentPunchcardController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    punchcard(query, workspaceId) {
+        return this.insights.punchcard(workspaceId, query.days ?? insights_range_query_dto_1.DEFAULT_INSIGHTS_DAYS);
+    }
+};
+exports.ContentPunchcardController = ContentPunchcardController;
+tslib_1.__decorate([
+    (0, common_1.Get)('punchcard'),
+    tslib_1.__param(0, (0, common_1.Query)()),
+    tslib_1.__param(1, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [insights_range_query_dto_1.InsightsRangeQueryDto, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentPunchcardController.prototype, "punchcard", null);
+exports.ContentPunchcardController = ContentPunchcardController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentPunchcardController);

package/dist/lib/insights/http/controllers/content-stale.controller.d.ts

@@ -0,0 +1,17 @@
+import { ContentInsightsQuery } from '../../infrastructure/queries/content-insights.query';
+import type { ContentStaleView } from '../../types/content-insights-view';
+/**
+ * `GET /api/insights/content/stale` — published entries bucketed by how long
+ * ago they were last edited.
+ *
+ * Takes no `?days=`: the buckets *are* the time axis, and they are fixed
+ * (30/90/180/365/older) so the answer means the same thing whichever range the
+ * page is set to. "What has nobody touched in a year" is not a question about
+ * the last 7 days.
+ */
+export declare class ContentStaleController {
+    private readonly insights;
+    constructor(insights: ContentInsightsQuery);
+    stale(workspaceId: string): Promise<ContentStaleView>;
+}
+//# sourceMappingURL=content-stale.controller.d.ts.map

package/dist/lib/insights/http/controllers/content-stale.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-stale.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/controllers/content-stale.controller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAGa,sBAAsB;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAG3D,KAAK,CAAqB,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG5E"}

package/dist/lib/insights/http/controllers/content-stale.controller.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentStaleController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+/**
+ * `GET /api/insights/content/stale` — published entries bucketed by how long
+ * ago they were last edited.
+ *
+ * Takes no `?days=`: the buckets *are* the time axis, and they are fixed
+ * (30/90/180/365/older) so the answer means the same thing whichever range the
+ * page is set to. "What has nobody touched in a year" is not a question about
+ * the last 7 days.
+ */
+let ContentStaleController = class ContentStaleController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    stale(workspaceId) {
+        return this.insights.stale(workspaceId);
+    }
+};
+exports.ContentStaleController = ContentStaleController;
+tslib_1.__decorate([
+    (0, common_1.Get)('stale'),
+    tslib_1.__param(0, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentStaleController.prototype, "stale", null);
+exports.ContentStaleController = ContentStaleController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentStaleController);

package/dist/lib/insights/http/controllers/content-totals.controller.d.ts

@@ -0,0 +1,18 @@
+import { ContentInsightsQuery } from '../../infrastructure/queries/content-insights.query';
+import type { ContentTotalsView } from '../../types/content-insights-view';
+import { InsightsRangeQueryDto } from '../dto/insights-range-query.dto';
+/**
+ * `GET /api/insights/content/totals` — entry, published and draft counts for
+ * the workspace, with the change over the window and a short history for the
+ * stat tiles' sparklines.
+ *
+ * Its own endpoint rather than a field on a combined Insights response: each
+ * widget on the page owns its own request, so a slow or failing aggregate
+ * degrades one card instead of blanking the dashboard.
+ */
+export declare class ContentTotalsController {
+    private readonly insights;
+    constructor(insights: ContentInsightsQuery);
+    totals(query: InsightsRangeQueryDto, workspaceId: string): Promise<ContentTotalsView>;
+}
+//# sourceMappingURL=content-totals.controller.d.ts.map

package/dist/lib/insights/http/controllers/content-totals.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-totals.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/controllers/content-totals.controller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAEH,qBAAqB,EACxB,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAGa,uBAAuB;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAG3D,MAAM,CACO,KAAK,EAAE,qBAAqB,EACjB,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,iBAAiB,CAAC;CAMhC"}

package/dist/lib/insights/http/controllers/content-totals.controller.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentTotalsController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+const insights_range_query_dto_1 = require("../dto/insights-range-query.dto");
+/**
+ * `GET /api/insights/content/totals` — entry, published and draft counts for
+ * the workspace, with the change over the window and a short history for the
+ * stat tiles' sparklines.
+ *
+ * Its own endpoint rather than a field on a combined Insights response: each
+ * widget on the page owns its own request, so a slow or failing aggregate
+ * degrades one card instead of blanking the dashboard.
+ */
+let ContentTotalsController = class ContentTotalsController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    totals(query, workspaceId) {
+        return this.insights.totals(workspaceId, query.days ?? insights_range_query_dto_1.DEFAULT_INSIGHTS_DAYS);
+    }
+};
+exports.ContentTotalsController = ContentTotalsController;
+tslib_1.__decorate([
+    (0, common_1.Get)('totals'),
+    tslib_1.__param(0, (0, common_1.Query)()),
+    tslib_1.__param(1, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [insights_range_query_dto_1.InsightsRangeQueryDto, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentTotalsController.prototype, "totals", null);
+exports.ContentTotalsController = ContentTotalsController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentTotalsController);

package/dist/lib/insights/http/controllers/content-unshipped.controller.d.ts

@@ -0,0 +1,17 @@
+import { ContentInsightsQuery } from '../../infrastructure/queries/content-insights.query';
+import type { ContentUnshippedView } from '../../types/content-insights-view';
+/**
+ * `GET /api/insights/content/unshipped` — entries that are live but carry
+ * unpublished edits (the admin's **Modified** state), per type and in total.
+ *
+ * Takes no `?days=`, for the same reason `stale` doesn't: a pending edit is
+ * pending whether it was made this morning or last spring, and windowing it
+ * would quietly answer "changes made recently that are unpublished" under a name
+ * that promises the backlog.
+ */
+export declare class ContentUnshippedController {
+    private readonly insights;
+    constructor(insights: ContentInsightsQuery);
+    unshipped(workspaceId: string): Promise<ContentUnshippedView>;
+}
+//# sourceMappingURL=content-unshipped.controller.d.ts.map

package/dist/lib/insights/http/controllers/content-unshipped.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-unshipped.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/controllers/content-unshipped.controller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;GAQG;AACH,qBAGa,0BAA0B;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAG3D,SAAS,CACe,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,oBAAoB,CAAC;CAGnC"}

package/dist/lib/insights/http/controllers/content-unshipped.controller.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentUnshippedController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+/**
+ * `GET /api/insights/content/unshipped` — entries that are live but carry
+ * unpublished edits (the admin's **Modified** state), per type and in total.
+ *
+ * Takes no `?days=`, for the same reason `stale` doesn't: a pending edit is
+ * pending whether it was made this morning or last spring, and windowing it
+ * would quietly answer "changes made recently that are unpublished" under a name
+ * that promises the backlog.
+ */
+let ContentUnshippedController = class ContentUnshippedController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    unshipped(workspaceId) {
+        return this.insights.unshipped(workspaceId);
+    }
+};
+exports.ContentUnshippedController = ContentUnshippedController;
+tslib_1.__decorate([
+    (0, common_1.Get)('unshipped'),
+    tslib_1.__param(0, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentUnshippedController.prototype, "unshipped", null);
+exports.ContentUnshippedController = ContentUnshippedController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentUnshippedController);

package/dist/lib/insights/http/controllers/content-velocity.controller.d.ts

@@ -0,0 +1,17 @@
+import { ContentInsightsQuery } from '../../infrastructure/queries/content-insights.query';
+import type { ContentVelocityView } from '../../types/content-insights-view';
+import { InsightsRangeQueryDto } from '../dto/insights-range-query.dto';
+/**
+ * `GET /api/insights/content/velocity` — entries published per time bucket
+ * across the selected window.
+ *
+ * Counts `published_at`, so an entry that was published, unpublished and
+ * published again contributes at its latest publish only. The column records a
+ * state, not a log, and the widget's caption is written to match.
+ */
+export declare class ContentVelocityController {
+    private readonly insights;
+    constructor(insights: ContentInsightsQuery);
+    velocity(query: InsightsRangeQueryDto, workspaceId: string): Promise<ContentVelocityView>;
+}
+//# sourceMappingURL=content-velocity.controller.d.ts.map

package/dist/lib/insights/http/controllers/content-velocity.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-velocity.controller.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/controllers/content-velocity.controller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAEH,qBAAqB,EACxB,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;GAOG;AACH,qBAGa,yBAAyB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,oBAAoB;IAG3D,QAAQ,CACK,KAAK,EAAE,qBAAqB,EACjB,WAAW,EAAE,MAAM,GACxC,OAAO,CAAC,mBAAmB,CAAC;CAMlC"}

package/dist/lib/insights/http/controllers/content-velocity.controller.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentVelocityController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identity_server_1 = require("@orthacms/identity-server");
+const workspaces_server_1 = require("@orthacms/workspaces-server");
+const content_insights_query_1 = require("../../infrastructure/queries/content-insights.query");
+const insights_range_query_dto_1 = require("../dto/insights-range-query.dto");
+/**
+ * `GET /api/insights/content/velocity` — entries published per time bucket
+ * across the selected window.
+ *
+ * Counts `published_at`, so an entry that was published, unpublished and
+ * published again contributes at its latest publish only. The column records a
+ * state, not a log, and the widget's caption is written to match.
+ */
+let ContentVelocityController = class ContentVelocityController {
+    insights;
+    constructor(insights) {
+        this.insights = insights;
+    }
+    velocity(query, workspaceId) {
+        return this.insights.velocity(workspaceId, query.days ?? insights_range_query_dto_1.DEFAULT_INSIGHTS_DAYS);
+    }
+};
+exports.ContentVelocityController = ContentVelocityController;
+tslib_1.__decorate([
+    (0, common_1.Get)('velocity'),
+    tslib_1.__param(0, (0, common_1.Query)()),
+    tslib_1.__param(1, (0, workspaces_server_1.CurrentWorkspace)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [insights_range_query_dto_1.InsightsRangeQueryDto, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ContentVelocityController.prototype, "velocity", null);
+exports.ContentVelocityController = ContentVelocityController = tslib_1.__decorate([
+    (0, common_1.UseGuards)(identity_server_1.PermissionsGuard, workspaces_server_1.WorkspaceGuard),
+    (0, identity_server_1.RequirePermissions)(identity_server_1.PERMISSIONS.CONTENT_READ),
+    (0, common_1.Controller)('insights/content'),
+    tslib_1.__metadata("design:paramtypes", [content_insights_query_1.ContentInsightsQuery])
+], ContentVelocityController);

package/dist/lib/insights/http/dto/insights-range-query.dto.d.ts

@@ -0,0 +1,15 @@
+/** Window used when a request names none — matches the page's default range. */
+export declare const DEFAULT_INSIGHTS_DAYS = 30;
+/**
+ * Longest window an Insights read may ask for.
+ *
+ * Bounded because every one of these endpoints fans out across each content
+ * type's table: an unbounded `?days=` would let a single request scan the whole
+ * history of every collection in the workspace.
+ */
+export declare const MAX_INSIGHTS_DAYS = 365;
+/** `?days=` — the window an Insights read reports over. */
+export declare class InsightsRangeQueryDto {
+    days?: number;
+}
+//# sourceMappingURL=insights-range-query.dto.d.ts.map

package/dist/lib/insights/http/dto/insights-range-query.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-range-query.dto.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/http/dto/insights-range-query.dto.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,2DAA2D;AAC3D,qBAAa,qBAAqB;IAe9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/lib/insights/http/dto/insights-range-query.dto.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsightsRangeQueryDto = exports.MAX_INSIGHTS_DAYS = exports.DEFAULT_INSIGHTS_DAYS = void 0;
+const tslib_1 = require("tslib");
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/** Window used when a request names none — matches the page's default range. */
+exports.DEFAULT_INSIGHTS_DAYS = 30;
+/**
+ * Longest window an Insights read may ask for.
+ *
+ * Bounded because every one of these endpoints fans out across each content
+ * type's table: an unbounded `?days=` would let a single request scan the whole
+ * history of every collection in the workspace.
+ */
+exports.MAX_INSIGHTS_DAYS = 365;
+/** `?days=` — the window an Insights read reports over. */
+class InsightsRangeQueryDto {
+    days;
+}
+exports.InsightsRangeQueryDto = InsightsRangeQueryDto;
+tslib_1.__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        type: 'integer',
+        minimum: 1,
+        maximum: exports.MAX_INSIGHTS_DAYS,
+        default: exports.DEFAULT_INSIGHTS_DAYS,
+        description: 'How many days back to report over. Bucket width is chosen from this: up to 31 days is grouped by day, up to 120 by week, beyond that by month.',
+        example: 30
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(exports.MAX_INSIGHTS_DAYS),
+    tslib_1.__metadata("design:type", Number)
+], InsightsRangeQueryDto.prototype, "days", void 0);

package/dist/lib/insights/infrastructure/queries/content-insights.query.d.ts

@@ -0,0 +1,77 @@
+import { type Database } from '@orthacms/database';
+import type { ContentTypeRegistry } from '../../../registry/content-type-registry';
+import type { ContentPipelineView, ContentPunchcardView, ContentStaleView, ContentTotalsView, ContentUnshippedView, ContentVelocityView } from '../../types/content-insights-view';
+/**
+ * Live read-model for the content Insights widgets.
+ *
+ * Every figure is aggregated **on demand** from the collection tables rather
+ * than folded into a projection. That is a deliberate trade for this stage: the
+ * counts are workspace-scoped and hit the existing
+ * `(workspace_id, …)` list indexes, so they are cheap at the scale a single
+ * workspace's content reaches, and a projection would add a table, migrations
+ * and a rebuild path to maintain before anything proved it was needed. The seam
+ * to change later is this class alone — the HTTP contract and the widgets don't
+ * know where the numbers come from.
+ *
+ * Each method queries **per content type** and merges in memory. There is no
+ * single table to group over: a collection is its own generated
+ * `content_<name>` table, so "entries in this workspace" is inherently a fan-out.
+ */
+export declare class ContentInsightsQuery {
+    private readonly db;
+    private readonly registry;
+    constructor(db: Database, registry: ContentTypeRegistry);
+    /**
+     * Restricts a read to one workspace, and to rows that still exist.
+     *
+     * The soft-delete clause is why this is shared rather than inlined: a
+     * tombstoned entry is still a row, and a count that forgets `deleted_at`
+     * silently reports deleted content as live — the kind of wrong number a
+     * dashboard is believed on.
+     */
+    private scope;
+    /** Counts rows of one type matching an extra predicate. */
+    private countOf;
+    /**
+     * Counts rows per time bucket over a window, for one type and one
+     * timestamp column. Returns raw buckets — the caller decides whether they
+     * are a series or the increments of a cumulative total.
+     */
+    private bucketed;
+    /** Headline counts, deltas and sparkline history for the stat tiles. */
+    totals(workspaceId: string, days: number): Promise<ContentTotalsView>;
+    /** Published entries grouped by how long ago they were last edited. */
+    stale(workspaceId: string): Promise<ContentStaleView>;
+    /** Draft/published split per content type. */
+    pipeline(workspaceId: string): Promise<ContentPipelineView>;
+    /**
+     * Live content carrying unpublished edits, per type and in total.
+     *
+     * The three figures come out of **one** grouped query per type rather than
+     * three `countOf` calls, because they partition the same rows: a scan that
+     * has already found a row can decide which of the three it belongs to.
+     *
+     * A **non-publishable** type contributes nothing at all — not even to
+     * `live`. It has no draft stage, so every row is trivially current, and
+     * folding those rows into the denominator would make "3 of 900 live records
+     * have pending edits" a number about a workspace's always-live singletons
+     * rather than about anything an editor can ship.
+     */
+    unshipped(workspaceId: string): Promise<ContentUnshippedView>;
+    /** Entries published per time bucket across the window. */
+    velocity(workspaceId: string, days: number): Promise<ContentVelocityView>;
+    /**
+     * Editing activity by weekday and hour, from the revision store.
+     *
+     * The one content figure that is a single grouped query rather than a
+     * fan-out: `content_entry_revisions` is generic across every type, so the
+     * whole workspace's editing history lives in one table.
+     *
+     * Hours come out in the database session's timezone (UTC in every
+     * deployment we run). Rendering them as local time would need each
+     * viewer's offset applied to the grouping, not to the labels — shifting
+     * the labels alone would silently mislabel the buckets.
+     */
+    punchcard(workspaceId: string, days: number): Promise<ContentPunchcardView>;
+}
+//# sourceMappingURL=content-insights.query.d.ts.map

package/dist/lib/insights/infrastructure/queries/content-insights.query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-insights.query.d.ts","sourceRoot":"","sources":["../../../../../src/lib/insights/infrastructure/queries/content-insights.query.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAInF,OAAO,KAAK,EACR,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EAEtB,MAAM,mCAAmC,CAAC;AAoE3C;;;;;;;;;;;;;;;GAeG;AACH,qBACa,oBAAoB;IAEP,OAAO,CAAC,QAAQ,CAAC,EAAE;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADf,EAAE,EAAE,QAAQ,EACL,QAAQ,EAAE,mBAAmB;IAG3E;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAQb,2DAA2D;YAC7C,OAAO;IAYrB;;;;OAIG;YACW,QAAQ;IAyBtB,wEAAwE;IAClE,MAAM,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC;IA2E7B,uEAAuE;IACjE,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoD3D,8CAA8C;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqCjE;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkDnE,2DAA2D;IACrD,QAAQ,CACV,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC;IAqB/B;;;;;;;;;;;OAWG;IACG,SAAS,CACX,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;CAyBnC"}