@timeback/core 0.2.1-beta.20260314155353 → 0.2.1-beta.20260315040428

package/dist/{chunk-wvs4tg34.js → chunk-87h1b7ca.js}

@@ -7,7 +7,7 @@ import {
   validateNonEmptyString,
   validateUuid,
   validateWithSchema
-} from "./chunk-k030r9e8.js";
+} from "./chunk-qt3x4rwv.js";
 
 // ../edubridge/src/utils.ts
 var log = createScopedLogger("edubridge");
@@ -1869,6 +1869,23 @@ var QtiLessonFeedbackInput = z11.object({
   lessonId: NonEmptyString,
   humanApproved: z11.boolean().optional()
 }).strict();
+// ../../types/src/zod/reporting.ts
+import { z as z12 } from "zod/v4";
+var ReportingAuthMode = z12.enum(["creator_only", "same_org", "all_orgs"]);
+var ReportingSavedQueryId = z12.string().uuid();
+var ReportingUserEmail = z12.email();
+var ReportingQueryInput = z12.object({
+  sql: NonEmptyString
+});
+var PersistReportingQueryInput = z12.object({
+  endpointName: NonEmptyString,
+  sql: NonEmptyString,
+  authMode: ReportingAuthMode,
+  description: NonEmptyString.optional()
+});
+var RemoveReportingQueryInput = z12.object({
+  endpointId: ReportingSavedQueryId
+});
 // ../edubridge/src/resources/analytics.ts
 class AnalyticsResource {
   transport;
@@ -2133,4 +2150,4 @@ function createEdubridgeClient(registry = DEFAULT_PROVIDER_REGISTRY) {
 
 // ../edubridge/src/client.ts
 var EdubridgeClient = createEdubridgeClient();
-export { ActivityCompletedInput, TimeSpentInput, CaliperEnvelopeInput, CaliperSendEventsInput, CaliperListEventsParams, QuestionSeenInput, QuestionAnsweredInput, QuestionGradedInput, WebhookCreateInput, WebhookUpdateInput, WebhookFilterCreateInput, WebhookFilterUpdateInput, CasePackageInput, ClrCredentialInput, OneRosterUserCreateInput, OneRosterCourseCreateInput, OneRosterClassCreateInput, OneRosterEnrollmentCreateInput, OneRosterCategoryCreateInput, OneRosterLineItemCreateInput, OneRosterResultCreateInput, OneRosterScoreScaleCreateInput, OneRosterAssessmentLineItemCreateInput, OneRosterAssessmentResultCreateInput, OneRosterOrgCreateInput, OneRosterSchoolCreateInput, OneRosterAcademicSessionCreateInput, OneRosterComponentResourceCreateInput, OneRosterCourseComponentCreateInput, OneRosterEnrollInput, OneRosterAgentInput, OneRosterCredentialInput, OneRosterDemographicsCreateInput, OneRosterResourceCreateInput, OneRosterCourseStructureInput, OneRosterBulkResultsInput, PowerPathCreateExternalPlacementTestInput, PowerPathCreateExternalTestOutInput, PowerPathCreateInternalTestInput, PowerPathCreateNewAttemptInput, PowerPathFinalStudentAssessmentResponseInput, PowerPathLessonPlansCreateInput, PowerPathLessonPlanOperationsInput, PowerPathLessonPlanUpdateStudentItemResponseInput, PowerPathMakeExternalTestAssignmentInput, PowerPathPlacementResetUserPlacementInput, PowerPathResetAttemptInput, PowerPathScreeningResetSessionInput, PowerPathScreeningAssignTestInput, PowerPathTestAssignmentsCreateInput, PowerPathTestAssignmentsUpdateInput, PowerPathTestAssignmentsBulkInput, PowerPathTestAssignmentsImportInput, PowerPathTestAssignmentsListParams, PowerPathTestAssignmentsAdminParams, PowerPathUpdateStudentQuestionResponseInput, PowerPathGetAssessmentProgressParams, PowerPathGetNextQuestionParams, PowerPathGetAttemptsParams, PowerPathTestOutParams, PowerPathImportExternalTestAssignmentResultsParams, PowerPathPlacementQueryParams, PowerPathMakeExternalStudentTestOutAssignmentInput, PowerPathRenderConfigUpsertInput, PowerPathSyllabusQueryParams, QtiAssessmentItemXmlCreateInput, QtiAssessmentItemJsonCreateInput, QtiAssessmentItemCreateInput, QtiAssessmentItemUpdateInput, QtiAssessmentItemProcessResponseInput, QtiAssessmentItemRef, QtiAssessmentSection, QtiTestPart, QtiReorderItemsInput, QtiAssessmentTestMetadataUpdateInput, QtiAssessmentTestCreateInput, QtiAssessmentTestUpdateInput, QtiStimulusCreateInput, QtiStimulusUpdateInput, QtiValidateInput, QtiValidateBatchInput, QtiLessonFeedbackInput, aggregateActivityMetrics, EdubridgeClient };
+export { ActivityCompletedInput, TimeSpentInput, CaliperEnvelopeInput, CaliperSendEventsInput, CaliperListEventsParams, QuestionSeenInput, QuestionAnsweredInput, QuestionGradedInput, WebhookCreateInput, WebhookUpdateInput, WebhookFilterCreateInput, WebhookFilterUpdateInput, CasePackageInput, ClrCredentialInput, OneRosterUserCreateInput, OneRosterCourseCreateInput, OneRosterClassCreateInput, OneRosterEnrollmentCreateInput, OneRosterCategoryCreateInput, OneRosterLineItemCreateInput, OneRosterResultCreateInput, OneRosterScoreScaleCreateInput, OneRosterAssessmentLineItemCreateInput, OneRosterAssessmentResultCreateInput, OneRosterOrgCreateInput, OneRosterSchoolCreateInput, OneRosterAcademicSessionCreateInput, OneRosterComponentResourceCreateInput, OneRosterCourseComponentCreateInput, OneRosterEnrollInput, OneRosterAgentInput, OneRosterCredentialInput, OneRosterDemographicsCreateInput, OneRosterResourceCreateInput, OneRosterCourseStructureInput, OneRosterBulkResultsInput, PowerPathCreateExternalPlacementTestInput, PowerPathCreateExternalTestOutInput, PowerPathCreateInternalTestInput, PowerPathCreateNewAttemptInput, PowerPathFinalStudentAssessmentResponseInput, PowerPathLessonPlansCreateInput, PowerPathLessonPlanOperationsInput, PowerPathLessonPlanUpdateStudentItemResponseInput, PowerPathMakeExternalTestAssignmentInput, PowerPathPlacementResetUserPlacementInput, PowerPathResetAttemptInput, PowerPathScreeningResetSessionInput, PowerPathScreeningAssignTestInput, PowerPathTestAssignmentsCreateInput, PowerPathTestAssignmentsUpdateInput, PowerPathTestAssignmentsBulkInput, PowerPathTestAssignmentsImportInput, PowerPathTestAssignmentsListParams, PowerPathTestAssignmentsAdminParams, PowerPathUpdateStudentQuestionResponseInput, PowerPathGetAssessmentProgressParams, PowerPathGetNextQuestionParams, PowerPathGetAttemptsParams, PowerPathTestOutParams, PowerPathImportExternalTestAssignmentResultsParams, PowerPathPlacementQueryParams, PowerPathMakeExternalStudentTestOutAssignmentInput, PowerPathRenderConfigUpsertInput, PowerPathSyllabusQueryParams, QtiAssessmentItemXmlCreateInput, QtiAssessmentItemJsonCreateInput, QtiAssessmentItemCreateInput, QtiAssessmentItemUpdateInput, QtiAssessmentItemProcessResponseInput, QtiAssessmentItemRef, QtiAssessmentSection, QtiTestPart, QtiReorderItemsInput, QtiAssessmentTestMetadataUpdateInput, QtiAssessmentTestCreateInput, QtiAssessmentTestUpdateInput, QtiStimulusCreateInput, QtiStimulusUpdateInput, QtiValidateInput, QtiValidateBatchInput, QtiLessonFeedbackInput, ReportingUserEmail, ReportingQueryInput, PersistReportingQueryInput, aggregateActivityMetrics, EdubridgeClient };

package/dist/{chunk-k030r9e8.js → chunk-qt3x4rwv.js}

@@ -644,6 +644,13 @@ var BEYONDAI_PATHS = {
     webhookFilterUpdate: "/webhook-filters/{id}",
     webhookFilterDelete: "/webhook-filters/{id}",
     webhookFiltersByWebhook: "/webhook-filters/webhook/{webhookId}"
+  },
+  reporting: {
+    mcp: "/lambda/mcp/reporting",
+    savedQueryExecute: "/lambda/reporting/saved-queries/{id}",
+    adminGroupCheck: "/lambda/mcp/admin/users/{email}/group",
+    adminGroupAdd: "/lambda/mcp/admin/users/{email}/group",
+    adminGroupRemove: "/lambda/mcp/admin/users/{email}/group"
   }
 };
 var LEARNWITHAI_PATHS = {
@@ -660,6 +667,7 @@ var LEARNWITHAI_PATHS = {
     resources: "/resources/1.0"
   },
   webhooks: null,
+  reporting: null,
   edubridge: null,
   powerpath: null,
   clr: null,
@@ -688,6 +696,7 @@ function resolvePathProfiles(pathProfile, customPaths) {
     caliper: customPaths?.caliper ?? basePaths.caliper,
     oneroster: customPaths?.oneroster ?? basePaths.oneroster,
     webhooks: customPaths?.webhooks ?? basePaths.webhooks,
+    reporting: customPaths?.reporting ?? basePaths.reporting,
     edubridge: customPaths?.edubridge ?? basePaths.edubridge,
     powerpath: customPaths?.powerpath ?? basePaths.powerpath,
     clr: customPaths?.clr ?? basePaths.clr,
@@ -749,6 +758,10 @@ class TimebackProvider {
           baseUrl: platformEndpoints.caliper[env],
           authUrl: this.authUrl
         },
+        reporting: {
+          baseUrl: platformEndpoints.api[env],
+          authUrl: this.authUrl
+        },
         qti: {
           baseUrl: platformEndpoints.qti[env],
           authUrl: this.authUrl
@@ -766,6 +779,7 @@ class TimebackProvider {
         case: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         caliper: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         webhooks: { baseUrl: config.baseUrl, authUrl: this.authUrl },
+        reporting: { baseUrl: config.baseUrl, authUrl: this.authUrl },
         qti: { baseUrl: config.baseUrl, authUrl: this.authUrl }
       };
     } else if (isServicesConfig(config)) {

package/dist/client.d.ts

@@ -6,6 +6,7 @@ import type { AuthCheckResult, TimebackProvider } from '@timeback/internal-clien
 import type { OneRosterClientInstance } from '@timeback/oneroster';
 import type { PowerPathClientInstance } from '@timeback/powerpath';
 import type { QtiClientInstance } from '@timeback/qti';
+import type { ReportingClientInstance } from '@timeback/reporting';
 import type { WebhooksClientInstance } from '@timeback/webhooks';
 import type { TimebackClientConfig } from './types/index';
 /**
@@ -20,6 +21,7 @@ import type { TimebackClientConfig } from './types/index';
  * - **OneRoster**: Rostering and gradebook data
  * - **Edubridge**: Simplified enrollments and analytics
  * - **Caliper**: Learning analytics events
+ * - **Reporting**: Ad-hoc queries and saved reporting endpoints
  * - **QTI**: Assessment content management
  * - **PowerPath**: Placement tests, lesson plans, and assessments
  * - **CLR**: Comprehensive Learner Record credentials
@@ -83,6 +85,7 @@ export declare class TimebackClient {
     private _powerpath?;
     private _clr?;
     private _case?;
+    private _reporting?;
     private _webhooks?;
     /**
      * Creates a new Timeback client.
@@ -162,6 +165,16 @@ export declare class TimebackClient {
      * @throws {Error} If client has been closed or service not configured
      */
     get case(): CaseClientInstance;
+    /**
+     * Reporting API client for reporting queries and saved reporting endpoints.
+     *
+     * Lazily initialized on first access. Shares OAuth tokens with other
+     * sub-clients through the provider.
+     *
+     * @returns The Reporting client instance
+     * @throws {Error} If client has been closed or service not configured
+     */
+    get reporting(): ReportingClientInstance;
     /**
      * Webhooks API client for managing webhook registrations and filters.
      *

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,CAAuB;IACxC,OAAO,CAAC,IAAI,CAAC,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAmB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAC,CAAwB;IAE1C;;;;;;OAMG;IACH,YAAY,MAAM,CAAC,EAAE,oBAAoB,EAUxC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,OAAO,IAAI,qBAAqB,CASnC;IAED;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,iBAAiB,CAS3B;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,iBAAiB,CAS3B;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,kBAAkB,CAS7B;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAAI,sBAAsB,CASrC;IAMD;;;;;;;;OAQG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAGpC;IAED;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI,CAeZ;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;OAIG;IACH,WAAW,IAAI,gBAAgB,CAE9B;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOrB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,CAAuB;IACxC,OAAO,CAAC,IAAI,CAAC,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAmB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAC,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAwB;IAE1C;;;;;;OAMG;IACH,YAAY,MAAM,CAAC,EAAE,oBAAoB,EAUxC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,OAAO,IAAI,qBAAqB,CASnC;IAED;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,iBAAiB,CAS3B;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,GAAG,IAAI,iBAAiB,CAS3B;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,kBAAkB,CAS7B;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,IAAI,uBAAuB,CASvC;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAAI,sBAAsB,CASrC;IAMD;;;;;;;;OAQG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAGpC;IAED;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI,CAgBZ;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;OAIG;IACH,WAAW,IAAI,gBAAgB,CAE9B;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAgBrB"}

package/dist/errors.js

@@ -4,7 +4,7 @@ import {
   NotFoundError,
   UnauthorizedError,
   ValidationError
-} from "./chunk-k030r9e8.js";
+} from "./chunk-qt3x4rwv.js";
 import"./chunk-3j7jywnx.js";
 export {
   ValidationError,

package/dist/index.js

@@ -28,6 +28,7 @@ import {
   OneRosterSchoolCreateInput,
   OneRosterScoreScaleCreateInput,
   OneRosterUserCreateInput,
+  PersistReportingQueryInput,
   PowerPathCreateExternalPlacementTestInput,
   PowerPathCreateExternalTestOutInput,
   PowerPathCreateInternalTestInput,
@@ -77,12 +78,14 @@ import {
   QuestionAnsweredInput,
   QuestionGradedInput,
   QuestionSeenInput,
+  ReportingQueryInput,
+  ReportingUserEmail,
   TimeSpentInput,
   WebhookCreateInput,
   WebhookFilterCreateInput,
   WebhookFilterUpdateInput,
   WebhookUpdateInput
-} from "./chunk-wvs4tg34.js";
+} from "./chunk-87h1b7ca.js";
 import {
   ApiError,
   BaseTransport,
@@ -108,7 +111,7 @@ import {
   validateUuid,
   validateWithSchema,
   whereToFilter
-} from "./chunk-k030r9e8.js";
+} from "./chunk-qt3x4rwv.js";
 import {
   CALIPER_DATA_VERSION,
   CALIPER_ENV_VARS,
@@ -3642,6 +3645,187 @@ function createQtiClient(registry = DEFAULT_PROVIDER_REGISTRY) {
 
 // ../qti/src/client.ts
 var QtiClient = createQtiClient();
+// ../reporting/src/constants.ts
+var REPORTING_ENV_VARS = {
+  baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "REPORTING_BASE_URL"],
+  authUrl: ["TIMEBACK_API_AUTH_URL", "TIMEBACK_AUTH_URL", "REPORTING_TOKEN_URL"],
+  clientId: ["TIMEBACK_API_CLIENT_ID", "TIMEBACK_CLIENT_ID", "REPORTING_CLIENT_ID"],
+  clientSecret: [
+    "TIMEBACK_API_CLIENT_SECRET",
+    "TIMEBACK_CLIENT_SECRET",
+    "REPORTING_CLIENT_SECRET"
+  ]
+};
+
+// ../reporting/src/lib/resolve.ts
+function resolveToProvider8(config, registry = DEFAULT_PROVIDER_REGISTRY) {
+  return resolveToProvider(config, REPORTING_ENV_VARS, registry);
+}
+
+// ../reporting/src/utils.ts
+var log7 = createScopedLogger("reporting");
+
+// ../reporting/src/lib/transport.ts
+class Transport7 extends BaseTransport {
+  paths;
+  constructor(config) {
+    super({ config, logger: log7 });
+    this.paths = config.paths;
+  }
+  async callTool(name, args) {
+    const response = await this.request(this.paths.mcp, {
+      method: "POST",
+      body: {
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tools/call",
+        params: {
+          name,
+          arguments: args
+        }
+      }
+    });
+    if (response.error) {
+      throw new ApiError(response.error.message, 500, response.error.data ?? response.error);
+    }
+    const rawContent = response.result?.content?.[0]?.text;
+    if (!rawContent) {
+      throw new ApiError("Missing reporting MCP result content", 500, response);
+    }
+    let payload;
+    try {
+      payload = JSON.parse(rawContent);
+    } catch {
+      throw new ApiError("Invalid reporting MCP response payload", 500, {
+        body: rawContent
+      });
+    }
+    const hasToolError = response.result?.isError === true || typeof payload === "object" && payload !== null && "isError" in payload && payload.isError === true;
+    if (hasToolError) {
+      const message = typeof payload === "object" && payload !== null && "error" in payload && typeof payload.error === "string" ? payload.error : `Reporting MCP tool failed: ${name}`;
+      throw new ApiError(message, 500, payload);
+    }
+    return payload;
+  }
+}
+
+// ../reporting/src/resources/admin.ts
+class AdminResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  checkGroupMembership(email) {
+    const validEmail = validateWithSchema(ReportingUserEmail, email, "reporting email");
+    log7.debug("Checking reporting group membership", { email: validEmail });
+    const path = this.transport.paths.adminGroupCheck.replace("{email}", encodeURIComponent(validEmail));
+    return this.transport.request(path);
+  }
+  addToGroup(email) {
+    const validEmail = validateWithSchema(ReportingUserEmail, email, "reporting email");
+    log7.debug("Adding user to reporting group", { email: validEmail });
+    const path = this.transport.paths.adminGroupAdd.replace("{email}", encodeURIComponent(validEmail));
+    return this.transport.request(path, { method: "POST" });
+  }
+  removeFromGroup(email) {
+    const validEmail = validateWithSchema(ReportingUserEmail, email, "reporting email");
+    log7.debug("Removing user from reporting group", { email: validEmail });
+    const path = this.transport.paths.adminGroupRemove.replace("{email}", encodeURIComponent(validEmail));
+    return this.transport.request(path, { method: "DELETE" });
+  }
+}
+// ../reporting/src/resources/queries.ts
+class QueriesResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  run(sql) {
+    const input = validateWithSchema(ReportingQueryInput, { sql }, "reporting query");
+    log7.debug("Running reporting query");
+    return this.transport.callTool("getData", input);
+  }
+}
+// ../reporting/src/resources/saved-queries.ts
+class SavedQueriesResource {
+  transport;
+  constructor(transport) {
+    this.transport = transport;
+  }
+  execute(id) {
+    validateUuid(id, "savedQueryId");
+    log7.debug("Executing saved reporting query", { id });
+    const path = this.transport.paths.savedQueryExecute.replace("{id}", encodeURIComponent(id));
+    return this.transport.request(path);
+  }
+  create(input) {
+    const payload = validateWithSchema(PersistReportingQueryInput, input, "saved reporting query");
+    log7.debug("Creating saved reporting query", { endpointName: payload.endpointName });
+    return this.transport.callTool("persistQueryToAPI", payload);
+  }
+  list() {
+    log7.debug("Listing saved reporting queries");
+    return this.transport.callTool("listApiEndpoints", {});
+  }
+  remove(id) {
+    validateUuid(id, "savedQueryId");
+    log7.debug("Removing saved reporting query", { id });
+    return this.transport.callTool("removeApiEndpoint", {
+      endpointId: id
+    });
+  }
+}
+// ../reporting/src/factory.ts
+function createReportingClient(registry = DEFAULT_PROVIDER_REGISTRY) {
+  return class ReportingClient {
+    transport;
+    _provider;
+    queries;
+    savedQueries;
+    admin;
+    constructor(config = {}) {
+      const resolved = resolveToProvider8(config, registry);
+      if (resolved.mode === "transport") {
+        this.transport = resolved.transport;
+        log7.info("Client initialized with custom transport");
+      } else {
+        const { provider } = resolved;
+        const { baseUrl, paths } = provider.getEndpointWithPaths("reporting");
+        const tokenProvider = provider.getTokenProvider("reporting");
+        if (!tokenProvider) {
+          throw new Error("Reporting API requires authentication");
+        }
+        this._provider = provider;
+        this.transport = new Transport7({
+          baseUrl,
+          tokenProvider,
+          timeout: provider.timeout,
+          paths
+        });
+        log7.info("Client initialized", {
+          platform: provider.platform,
+          env: provider.env,
+          baseUrl
+        });
+      }
+      this.queries = new QueriesResource(this.transport);
+      this.savedQueries = new SavedQueriesResource(this.transport);
+      this.admin = new AdminResource(this.transport);
+    }
+    getTransport() {
+      return this.transport;
+    }
+    checkAuth() {
+      if (!this._provider) {
+        throw new Error("Cannot check auth: client initialized with custom transport");
+      }
+      return this._provider.checkAuth();
+    }
+  };
+}
+
+// ../reporting/src/client.ts
+var ReportingClient = createReportingClient();
 // ../webhooks/src/constants.ts
 var WEBHOOKS_ENV_VARS = {
   baseUrl: ["TIMEBACK_API_BASE_URL", "TIMEBACK_BASE_URL", "WEBHOOKS_BASE_URL"],
@@ -3655,18 +3839,18 @@ var WEBHOOKS_ENV_VARS = {
 };
 
 // ../webhooks/src/lib/resolve.ts
-function resolveToProvider8(config, registry = DEFAULT_PROVIDER_REGISTRY) {
+function resolveToProvider9(config, registry = DEFAULT_PROVIDER_REGISTRY) {
   return resolveToProvider(config, WEBHOOKS_ENV_VARS, registry);
 }
 
 // ../webhooks/src/utils.ts
-var log7 = createScopedLogger("webhooks");
+var log8 = createScopedLogger("webhooks");
 
 // ../webhooks/src/lib/transport.ts
-class Transport7 extends BaseTransport {
+class Transport8 extends BaseTransport {
   paths;
   constructor(config) {
-    super({ config, logger: log7 });
+    super({ config, logger: log8 });
     this.paths = config.paths;
   }
 }
@@ -3682,13 +3866,13 @@ class WebhooksResource {
     if (sensor) {
       params.sensor = sensor;
     }
-    log7.debug("Listing webhooks", { sensor });
+    log8.debug("Listing webhooks", { sensor });
     const response = await this.transport.request(this.transport.paths.webhookList, { params });
     return response.webhooks;
   }
   async get(id) {
     validateNonEmptyString(id, "webhookId");
-    log7.debug("Getting webhook", { id });
+    log8.debug("Getting webhook", { id });
     const path = this.transport.paths.webhookGet.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path);
     if (!response.webhook) {
@@ -3698,15 +3882,15 @@ class WebhooksResource {
   }
   async create(input) {
     validateWithSchema(WebhookCreateInput, input, "webhook");
-    log7.debug("Creating webhook", { name: input.name });
+    log8.debug("Creating webhook", { name: input.name });
     const response = await this.transport.request(this.transport.paths.webhookCreate, { method: "POST", body: input });
-    log7.info("Webhook created", { id: response.webhook.id, name: response.webhook.name });
+    log8.info("Webhook created", { id: response.webhook.id, name: response.webhook.name });
     return response.webhook;
   }
   async update(id, input) {
     validateNonEmptyString(id, "webhookId");
     validateWithSchema(WebhookUpdateInput, input, "webhook");
-    log7.debug("Updating webhook", { id });
+    log8.debug("Updating webhook", { id });
     const path = this.transport.paths.webhookUpdate.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "PUT",
@@ -3716,32 +3900,32 @@ class WebhooksResource {
   }
   async delete(id) {
     validateNonEmptyString(id, "webhookId");
-    log7.debug("Deleting webhook", { id });
+    log8.debug("Deleting webhook", { id });
     const path = this.transport.paths.webhookDelete.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "DELETE"
     });
-    log7.info("Webhook deleted", { id });
+    log8.info("Webhook deleted", { id });
     return response;
   }
   async activate(id) {
     validateNonEmptyString(id, "webhookId");
-    log7.debug("Activating webhook", { id });
+    log8.debug("Activating webhook", { id });
     const path = this.transport.paths.webhookActivate.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "PUT"
     });
-    log7.info("Webhook activated", { id });
+    log8.info("Webhook activated", { id });
     return response.webhook;
   }
   async deactivate(id) {
     validateNonEmptyString(id, "webhookId");
-    log7.debug("Deactivating webhook", { id });
+    log8.debug("Deactivating webhook", { id });
     const path = this.transport.paths.webhookDeactivate.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "PUT"
     });
-    log7.info("Webhook deactivated", { id });
+    log8.info("Webhook deactivated", { id });
     return response.webhook;
   }
 }
@@ -3752,13 +3936,13 @@ class WebhookFiltersResource {
     this.transport = transport;
   }
   async list() {
-    log7.debug("Listing webhook filters");
+    log8.debug("Listing webhook filters");
     const response = await this.transport.request(this.transport.paths.webhookFilterList);
     return response.filters;
   }
   async get(id) {
     validateNonEmptyString(id, "webhookFilterId");
-    log7.debug("Getting webhook filter", { id });
+    log8.debug("Getting webhook filter", { id });
     const path = this.transport.paths.webhookFilterGet.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path);
     if (!response.filter) {
@@ -3768,25 +3952,25 @@ class WebhookFiltersResource {
   }
   async listByWebhook(webhookId) {
     validateNonEmptyString(webhookId, "webhookId");
-    log7.debug("Listing webhook filters by webhook", { webhookId });
+    log8.debug("Listing webhook filters by webhook", { webhookId });
     const path = this.transport.paths.webhookFiltersByWebhook.replace("{webhookId}", encodeURIComponent(webhookId));
     const response = await this.transport.request(path);
     return response.filters;
   }
   async create(input) {
     validateWithSchema(WebhookFilterCreateInput, input, "webhook filter");
-    log7.debug("Creating webhook filter", {
+    log8.debug("Creating webhook filter", {
       webhookId: input.webhookId,
       filterKey: input.filterKey
     });
     const response = await this.transport.request(this.transport.paths.webhookFilterCreate, { method: "POST", body: input });
-    log7.info("Webhook filter created", { webhookId: input.webhookId });
+    log8.info("Webhook filter created", { webhookId: input.webhookId });
     return response.filter;
   }
   async update(id, input) {
     validateNonEmptyString(id, "webhookFilterId");
     validateWithSchema(WebhookFilterUpdateInput, input, "webhook filter");
-    log7.debug("Updating webhook filter", { id });
+    log8.debug("Updating webhook filter", { id });
     const path = this.transport.paths.webhookFilterUpdate.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "PUT",
@@ -3796,12 +3980,12 @@ class WebhookFiltersResource {
   }
   async delete(id) {
     validateNonEmptyString(id, "webhookFilterId");
-    log7.debug("Deleting webhook filter", { id });
+    log8.debug("Deleting webhook filter", { id });
     const path = this.transport.paths.webhookFilterDelete.replace("{id}", encodeURIComponent(id));
     const response = await this.transport.request(path, {
       method: "DELETE"
     });
-    log7.info("Webhook filter deleted", { id });
+    log8.info("Webhook filter deleted", { id });
     return response;
   }
 }
@@ -3813,10 +3997,10 @@ function createWebhooksClient(registry = DEFAULT_PROVIDER_REGISTRY) {
     webhooks;
     webhookFilters;
     constructor(config = {}) {
-      const resolved = resolveToProvider8(config, registry);
+      const resolved = resolveToProvider9(config, registry);
       if (resolved.mode === "transport") {
         this.transport = resolved.transport;
-        log7.info("Client initialized with custom transport");
+        log8.info("Client initialized with custom transport");
       } else {
         const { provider } = resolved;
         const { baseUrl, paths } = provider.getEndpointWithPaths("webhooks");
@@ -3825,13 +4009,13 @@ function createWebhooksClient(registry = DEFAULT_PROVIDER_REGISTRY) {
           throw new Error("Webhooks API requires authentication");
         }
         this._provider = provider;
-        this.transport = new Transport7({
+        this.transport = new Transport8({
           baseUrl,
           tokenProvider,
           timeout: provider.timeout,
           paths
         });
-        log7.info("Client initialized", {
+        log8.info("Client initialized", {
           platform: provider.platform,
           env: provider.env,
           baseUrl
@@ -3885,6 +4069,7 @@ class TimebackClient {
   _powerpath;
   _clr;
   _case;
+  _reporting;
   _webhooks;
   constructor(config) {
     const resolved = resolveToProvider(config ?? {}, TIMEBACK_ENV_VARS);
@@ -3949,6 +4134,14 @@ class TimebackClient {
     }
     return this._case;
   }
+  get reporting() {
+    this.assertOpen();
+    this.assertService("reporting");
+    if (!this._reporting) {
+      this._reporting = new ReportingClient({ provider: this.provider });
+    }
+    return this._reporting;
+  }
   get webhooks() {
     this.assertOpen();
     this.assertService("webhooks");
@@ -3973,6 +4166,7 @@ class TimebackClient {
     this._powerpath = undefined;
     this._clr = undefined;
     this._case = undefined;
+    this._reporting = undefined;
     this._webhooks = undefined;
     this._closed = true;
   }

package/dist/utils.js

@@ -1,7 +1,7 @@
 import {
   aggregateActivityMetrics
-} from "./chunk-wvs4tg34.js";
-import"./chunk-k030r9e8.js";
+} from "./chunk-87h1b7ca.js";
+import"./chunk-qt3x4rwv.js";
 import"./chunk-3j7jywnx.js";
 export {
   aggregateActivityMetrics

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@timeback/core",
-	"version": "0.2.1-beta.20260314155353",
+	"version": "0.2.1-beta.20260315040428",
 	"type": "module",
 	"exports": {
 		".": {
@@ -46,6 +46,7 @@
 		"@timeback/oneroster": "0.2.0",
 		"@timeback/powerpath": "0.2.0",
 		"@timeback/qti": "0.2.0",
+		"@timeback/reporting": "0.1.0",
 		"@timeback/webhooks": "0.2.0",
 		"@types/bun": "latest",
 		"esbuild": "^0.27.3"