@adcp/sdk 5.23.0

package/dist/lib/server/postgres-task-store.d.ts

@@ -0,0 +1,121 @@
+/**
+ * PostgreSQL-backed TaskStore for distributed MCP servers.
+ *
+ * Replaces InMemoryTaskStore when running multiple server instances behind
+ * a load balancer. Tasks are stored in a shared table so any instance can
+ * create, retrieve, or update a task regardless of which instance handled
+ * the original request.
+ *
+ * @example
+ * ```typescript
+ * import { Pool } from 'pg';
+ * import { PostgresTaskStore, serve, createTaskCapableServer } from '@adcp/sdk';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const taskStore = new PostgresTaskStore(pool);
+ *
+ * serve(({ taskStore }) => createTaskCapableServer('My Agent', '1.0.0', { taskStore }), {
+ *   taskStore,
+ * });
+ * ```
+ */
+import type { TaskStore, CreateTaskOptions } from '@modelcontextprotocol/sdk/experimental/tasks/interfaces.js';
+import type { Task, RequestId, Result, Request } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Minimal subset of the `pg.Pool` interface used by PostgresTaskStore.
+ *
+ * Accepting this instead of a concrete Pool lets callers pass any
+ * pg-compatible query executor (connection pools, transaction wrappers, etc.)
+ * without forcing a hard dependency on the `pg` package.
+ */
+export interface PgQueryable {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+        rowCount: number | null;
+    }>;
+}
+/** Configuration for PostgresTaskStore. */
+export interface PostgresTaskStoreOptions {
+    /** Table name for task storage. Must contain only lowercase letters, digits, and underscores. Defaults to `"adcp_mcp_tasks"`. */
+    tableName?: string;
+}
+/**
+ * Generate the SQL DDL for the task store table.
+ *
+ * Constraint and index names are derived from the table name to avoid
+ * collisions when multiple stores share the same database.
+ *
+ * @example
+ * ```typescript
+ * import { getMcpTasksMigration } from '@adcp/sdk';
+ * await pool.query(getMcpTasksMigration()); // creates adcp_mcp_tasks
+ * await pool.query(getMcpTasksMigration({ tableName: 'my_tasks' })); // custom name
+ * ```
+ */
+export declare function getMcpTasksMigration(options?: {
+    tableName?: string;
+}): string;
+/** Backward-compatible constant using the default table name. */
+export declare const MCP_TASKS_MIGRATION: string;
+/**
+ * PostgreSQL-backed implementation of the MCP SDK TaskStore interface.
+ *
+ * All reads filter out expired tasks (via `expires_at`), so no background
+ * timer is needed — expired tasks are simply invisible. Call
+ * `cleanupExpired()` periodically to reclaim storage.
+ */
+export declare class PostgresTaskStore implements TaskStore {
+    private readonly db;
+    private readonly table;
+    constructor(db: PgQueryable, options?: PostgresTaskStoreOptions);
+    /**
+     * Create a new task. Pass `taskParams.taskId` to use a caller-supplied ID verbatim
+     * (useful for compliance-controller scenarios where the runner needs deterministic
+     * task IDs). If omitted, a random hex ID is generated. Throws if the supplied ID
+     * is empty / longer than 128 chars, or already exists. The 128-char ceiling is an
+     * SDK policy (matches typical request-id / session-id field lengths and keeps
+     * the task_id index efficient) — Postgres TEXT itself imposes no limit.
+     *
+     * The `task_id` namespace on this store is global (no tenant scoping in the schema
+     * today). Callers using caller-supplied IDs are responsible for namespace isolation;
+     * cross-tenant collisions surface as `already exists`. Track the schema fix
+     * (composite key on tenant + task_id) in a future SDK migration if production paths
+     * ever wire caller-supplied IDs.
+     */
+    createTask(taskParams: CreateTaskOptions & {
+        taskId?: string;
+    }, requestId: RequestId, request: Request, _sessionId?: string): Promise<Task>;
+    getTask(taskId: string, _sessionId?: string): Promise<Task | null>;
+    storeTaskResult(taskId: string, status: 'completed' | 'failed', result: Result, _sessionId?: string): Promise<void>;
+    getTaskResult(taskId: string, _sessionId?: string): Promise<Result>;
+    updateTaskStatus(taskId: string, status: Task['status'], statusMessage?: string, _sessionId?: string): Promise<void>;
+    listTasks(cursor?: string, _sessionId?: string): Promise<{
+        tasks: Task[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Delete expired tasks from the table.
+     *
+     * Call this on a schedule (e.g., every 5 minutes) to reclaim storage.
+     * Reads automatically filter expired rows, so this is purely a storage
+     * optimization — not required for correctness.
+     *
+     * @returns The number of deleted rows.
+     */
+    cleanupExpired(): Promise<number>;
+    /**
+     * No-op — PostgresTaskStore has no timers or background processes.
+     * Matches the cleanup() method that InMemoryTaskStore exposes.
+     */
+    cleanup(): void;
+}
+/**
+ * Delete expired tasks from the task store table.
+ *
+ * Standalone version of `PostgresTaskStore.cleanupExpired()` for use
+ * without a store instance.
+ *
+ * @returns The number of deleted rows.
+ */
+export declare function cleanupExpiredTasks(db: PgQueryable, tableName?: string): Promise<number>;
+//# sourceMappingURL=postgres-task-store.d.ts.map

package/dist/lib/server/postgres-task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-task-store.d.ts","sourceRoot":"","sources":["../../../src/lib/server/postgres-task-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,4DAA4D,CAAC;AAC/G,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAChH;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC,iIAAiI;IACjI,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA8B7E;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,QAAyB,CAAC;AAsC1D;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAI/C,OAAO,CAAC,QAAQ,CAAC,EAAE;IAHrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAGZ,EAAE,EAAE,WAAW,EAChC,OAAO,CAAC,EAAE,wBAAwB;IAQpC;;;;;;;;;;;;;OAaG;IACG,UAAU,CACd,UAAU,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EACnD,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAoCV,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAKlE,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgCV,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAenE,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EACtB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgCV,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoDtG;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAOvC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7G"}

package/dist/lib/server/postgres-task-store.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * PostgreSQL-backed TaskStore for distributed MCP servers.
+ *
+ * Replaces InMemoryTaskStore when running multiple server instances behind
+ * a load balancer. Tasks are stored in a shared table so any instance can
+ * create, retrieve, or update a task regardless of which instance handled
+ * the original request.
+ *
+ * @example
+ * ```typescript
+ * import { Pool } from 'pg';
+ * import { PostgresTaskStore, serve, createTaskCapableServer } from '@adcp/sdk';
+ *
+ * const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+ * const taskStore = new PostgresTaskStore(pool);
+ *
+ * serve(({ taskStore }) => createTaskCapableServer('My Agent', '1.0.0', { taskStore }), {
+ *   taskStore,
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresTaskStore = exports.MCP_TASKS_MIGRATION = void 0;
+exports.getMcpTasksMigration = getMcpTasksMigration;
+exports.cleanupExpiredTasks = cleanupExpiredTasks;
+const node_crypto_1 = require("node:crypto");
+/** Default table name — vendor-prefixed to avoid collisions in consumer databases. */
+const DEFAULT_TABLE = 'adcp_mcp_tasks';
+/** Validates a SQL identifier to prevent injection via table/constraint names. */
+const VALID_IDENTIFIER = /^[a-z_][a-z0-9_]*$/;
+/** Page size for listTasks pagination (matches InMemoryTaskStore). */
+const PAGE_SIZE = 10;
+/**
+ * Generate the SQL DDL for the task store table.
+ *
+ * Constraint and index names are derived from the table name to avoid
+ * collisions when multiple stores share the same database.
+ *
+ * @example
+ * ```typescript
+ * import { getMcpTasksMigration } from '@adcp/sdk';
+ * await pool.query(getMcpTasksMigration()); // creates adcp_mcp_tasks
+ * await pool.query(getMcpTasksMigration({ tableName: 'my_tasks' })); // custom name
+ * ```
+ */
+function getMcpTasksMigration(options) {
+    const table = options?.tableName ?? DEFAULT_TABLE;
+    if (!VALID_IDENTIFIER.test(table)) {
+        throw new Error(`Invalid table name "${table}": must match ${VALID_IDENTIFIER}`);
+    }
+    return `
+CREATE TABLE IF NOT EXISTS ${table} (
+  task_id         TEXT PRIMARY KEY,
+  status          TEXT NOT NULL DEFAULT 'working',
+  ttl             INTEGER,
+  poll_interval   INTEGER NOT NULL DEFAULT 1000,
+  status_message  TEXT,
+  request_id      TEXT NOT NULL,
+  request         JSONB NOT NULL,
+  result          JSONB,
+  created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  last_updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  expires_at      TIMESTAMPTZ,
+
+  CONSTRAINT ${table}_valid_status CHECK (
+    status IN ('working', 'input_required', 'completed', 'failed', 'cancelled')
+  )
+);
+
+CREATE INDEX IF NOT EXISTS idx_${table}_expires_at
+  ON ${table}(expires_at) WHERE expires_at IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_${table}_created_at
+  ON ${table}(created_at);
+`.trim();
+}
+/** Backward-compatible constant using the default table name. */
+exports.MCP_TASKS_MIGRATION = getMcpTasksMigration();
+/** Convert a database row to an MCP Task object. */
+function rowToTask(row) {
+    const task = {
+        taskId: row.task_id,
+        status: row.status,
+        ttl: row.ttl,
+        createdAt: new Date(row.created_at).toISOString(),
+        lastUpdatedAt: new Date(row.last_updated_at).toISOString(),
+    };
+    if (row.poll_interval != null) {
+        task.pollInterval = row.poll_interval;
+    }
+    if (row.status_message != null) {
+        task.statusMessage = row.status_message;
+    }
+    return task;
+}
+/** WHERE clause that filters out expired tasks. */
+const NOT_EXPIRED = `(expires_at IS NULL OR expires_at > NOW())`;
+/**
+ * PostgreSQL-backed implementation of the MCP SDK TaskStore interface.
+ *
+ * All reads filter out expired tasks (via `expires_at`), so no background
+ * timer is needed — expired tasks are simply invisible. Call
+ * `cleanupExpired()` periodically to reclaim storage.
+ */
+class PostgresTaskStore {
+    db;
+    table;
+    constructor(db, options) {
+        this.db = db;
+        this.table = options?.tableName ?? DEFAULT_TABLE;
+        if (!VALID_IDENTIFIER.test(this.table)) {
+            throw new Error(`Invalid table name "${this.table}": must match ${VALID_IDENTIFIER}`);
+        }
+    }
+    /**
+     * Create a new task. Pass `taskParams.taskId` to use a caller-supplied ID verbatim
+     * (useful for compliance-controller scenarios where the runner needs deterministic
+     * task IDs). If omitted, a random hex ID is generated. Throws if the supplied ID
+     * is empty / longer than 128 chars, or already exists. The 128-char ceiling is an
+     * SDK policy (matches typical request-id / session-id field lengths and keeps
+     * the task_id index efficient) — Postgres TEXT itself imposes no limit.
+     *
+     * The `task_id` namespace on this store is global (no tenant scoping in the schema
+     * today). Callers using caller-supplied IDs are responsible for namespace isolation;
+     * cross-tenant collisions surface as `already exists`. Track the schema fix
+     * (composite key on tenant + task_id) in a future SDK migration if production paths
+     * ever wire caller-supplied IDs.
+     */
+    async createTask(taskParams, requestId, request, _sessionId) {
+        if (taskParams.taskId !== undefined) {
+            if (typeof taskParams.taskId !== 'string' || taskParams.taskId.length === 0) {
+                throw new Error('taskId must be a non-empty string when supplied');
+            }
+            if (taskParams.taskId.length > 128) {
+                throw new Error(`taskId must be 128 characters or fewer (got ${taskParams.taskId.length})`);
+            }
+        }
+        const taskId = taskParams.taskId ?? (0, node_crypto_1.randomBytes)(16).toString('hex');
+        const ttl = taskParams.ttl ?? null;
+        const pollInterval = taskParams.pollInterval ?? 1000;
+        try {
+            const { rows } = await this.db.query(`INSERT INTO ${this.table} (task_id, status, ttl, poll_interval, request_id, request, expires_at)
+         VALUES ($1, 'working', $2, $3, $4, $5,
+                 CASE WHEN $2::integer IS NOT NULL
+                      THEN NOW() + ($2::integer || ' milliseconds')::interval
+                      ELSE NULL END)
+         RETURNING *`, [taskId, ttl, pollInterval, String(requestId), JSON.stringify(request)]);
+            return rowToTask(rows[0]);
+        }
+        catch (err) {
+            // Unique constraint violation — a task with this ID already exists.
+            if (typeof err === 'object' && err !== null && err.code === '23505') {
+                throw new Error(`Task with ID ${taskId} already exists. Use a different taskId or retrieve the existing task via getTask().`);
+            }
+            throw err;
+        }
+    }
+    async getTask(taskId, _sessionId) {
+        const { rows } = await this.db.query(`SELECT * FROM ${this.table} WHERE task_id = $1 AND ${NOT_EXPIRED}`, [taskId]);
+        return rows.length > 0 ? rowToTask(rows[0]) : null;
+    }
+    async storeTaskResult(taskId, status, result, _sessionId) {
+        // Atomic check-and-update: only modify if task exists and is non-terminal.
+        const { rowCount, rows } = await this.db.query(`UPDATE ${this.table}
+       SET status = $2,
+           result = $3,
+           last_updated_at = NOW(),
+           expires_at = CASE WHEN ttl IS NOT NULL
+                             THEN NOW() + (ttl || ' milliseconds')::interval
+                             ELSE NULL END
+       WHERE task_id = $1
+         AND status NOT IN ('completed', 'failed', 'cancelled')
+         AND ${NOT_EXPIRED}
+       RETURNING status`, [taskId, status, JSON.stringify(result)]);
+        if (!rowCount || rows.length === 0) {
+            // Distinguish "not found" / "expired" from "already terminal".
+            const { rows: existing } = await this.db.query(`SELECT status FROM ${this.table} WHERE task_id = $1 AND ${NOT_EXPIRED}`, [taskId]);
+            if (existing.length === 0) {
+                throw new Error(`Task with ID ${taskId} not found`);
+            }
+            throw new Error(`Cannot store result for task ${taskId} in terminal status '${existing[0].status}'. Task results can only be stored once.`);
+        }
+    }
+    async getTaskResult(taskId, _sessionId) {
+        const { rows } = await this.db.query(`SELECT result FROM ${this.table} WHERE task_id = $1 AND ${NOT_EXPIRED}`, [
+            taskId,
+        ]);
+        if (rows.length === 0) {
+            throw new Error(`Task with ID ${taskId} not found`);
+        }
+        const row = rows[0];
+        if (row.result == null) {
+            throw new Error(`Task ${taskId} has no result stored`);
+        }
+        return row.result;
+    }
+    async updateTaskStatus(taskId, status, statusMessage, _sessionId) {
+        // Atomic: only update if not already in a terminal state.
+        const { rowCount, rows } = await this.db.query(`UPDATE ${this.table}
+       SET status = $2,
+           status_message = COALESCE($3, status_message),
+           last_updated_at = NOW(),
+           expires_at = CASE
+             WHEN $2 IN ('completed', 'failed', 'cancelled') AND ttl IS NOT NULL
+               THEN NOW() + (ttl || ' milliseconds')::interval
+             ELSE expires_at END
+       WHERE task_id = $1
+         AND status NOT IN ('completed', 'failed', 'cancelled')
+         AND ${NOT_EXPIRED}
+       RETURNING status`, [taskId, status, statusMessage ?? null]);
+        if (!rowCount || rows.length === 0) {
+            const { rows: existing } = await this.db.query(`SELECT status FROM ${this.table} WHERE task_id = $1 AND ${NOT_EXPIRED}`, [taskId]);
+            if (existing.length === 0) {
+                throw new Error(`Task with ID ${taskId} not found`);
+            }
+            throw new Error(`Cannot update task ${taskId} from terminal status '${existing[0].status}' to '${status}'. Terminal states (completed, failed, cancelled) cannot transition to other states.`);
+        }
+    }
+    async listTasks(cursor, _sessionId) {
+        let rawRows;
+        if (cursor) {
+            // Decode cursor: "created_at|task_id" — split on first | only,
+            // so task IDs containing | are handled correctly.
+            const sepIndex = cursor.indexOf('|');
+            if (sepIndex < 1) {
+                throw new Error(`Invalid cursor: ${cursor}`);
+            }
+            const cursorCreatedAt = cursor.slice(0, sepIndex);
+            const cursorTaskId = cursor.slice(sepIndex + 1);
+            if (!cursorTaskId || isNaN(Date.parse(cursorCreatedAt))) {
+                throw new Error(`Invalid cursor: ${cursor}`);
+            }
+            ({ rows: rawRows } = await this.db.query(`SELECT *, created_at::text AS created_at_raw FROM ${this.table}
+         WHERE ${NOT_EXPIRED}
+           AND (created_at, task_id) > ($1::timestamptz, $2)
+         ORDER BY created_at, task_id
+         LIMIT $3`, [cursorCreatedAt, cursorTaskId, PAGE_SIZE + 1]));
+        }
+        else {
+            ({ rows: rawRows } = await this.db.query(`SELECT *, created_at::text AS created_at_raw FROM ${this.table}
+         WHERE ${NOT_EXPIRED}
+         ORDER BY created_at, task_id
+         LIMIT $1`, [PAGE_SIZE + 1]));
+        }
+        const rows = rawRows;
+        const hasMore = rows.length > PAGE_SIZE;
+        const pageRows = hasMore ? rows.slice(0, PAGE_SIZE) : rows;
+        const tasks = pageRows.map(rowToTask);
+        let nextCursor;
+        if (hasMore && pageRows.length > 0) {
+            const last = pageRows[pageRows.length - 1];
+            // Use the raw PostgreSQL text representation to preserve microsecond
+            // precision. JavaScript Date only has millisecond precision, which
+            // causes keyset pagination to re-include rows when multiple tasks
+            // share the same millisecond.
+            nextCursor = `${last.created_at_raw}|${last.task_id}`;
+        }
+        return { tasks, nextCursor };
+    }
+    /**
+     * Delete expired tasks from the table.
+     *
+     * Call this on a schedule (e.g., every 5 minutes) to reclaim storage.
+     * Reads automatically filter expired rows, so this is purely a storage
+     * optimization — not required for correctness.
+     *
+     * @returns The number of deleted rows.
+     */
+    async cleanupExpired() {
+        const { rowCount } = await this.db.query(`DELETE FROM ${this.table} WHERE expires_at IS NOT NULL AND expires_at <= NOW()`);
+        return rowCount ?? 0;
+    }
+    /**
+     * No-op — PostgresTaskStore has no timers or background processes.
+     * Matches the cleanup() method that InMemoryTaskStore exposes.
+     */
+    cleanup() {
+        // Nothing to clean up — no timers.
+    }
+}
+exports.PostgresTaskStore = PostgresTaskStore;
+/**
+ * Delete expired tasks from the task store table.
+ *
+ * Standalone version of `PostgresTaskStore.cleanupExpired()` for use
+ * without a store instance.
+ *
+ * @returns The number of deleted rows.
+ */
+async function cleanupExpiredTasks(db, tableName = DEFAULT_TABLE) {
+    if (!VALID_IDENTIFIER.test(tableName)) {
+        throw new Error(`Invalid table name "${tableName}": must match ${VALID_IDENTIFIER}`);
+    }
+    const { rowCount } = await db.query(`DELETE FROM ${tableName} WHERE expires_at IS NOT NULL AND expires_at <= NOW()`);
+    return rowCount ?? 0;
+}
+//# sourceMappingURL=postgres-task-store.js.map

package/dist/lib/server/postgres-task-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-task-store.js","sourceRoot":"","sources":["../../../src/lib/server/postgres-task-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/server/product-defaults.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sensible defaults for ReportingCapabilities — a required field on Product
+ * with 6 required sub-fields. Spread into your product definitions:
+ *
+ * @example
+ * ```typescript
+ * const product = {
+ *   product_id: 'display-1',
+ *   name: 'Display Ads',
+ *   reporting_capabilities: DEFAULT_REPORTING_CAPABILITIES,
+ * };
+ * ```
+ */
+import type { ReportingCapabilities } from '../types/core.generated';
+export declare const DEFAULT_REPORTING_CAPABILITIES: ReportingCapabilities;
+//# sourceMappingURL=product-defaults.d.ts.map

package/dist/lib/server/product-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-defaults.d.ts","sourceRoot":"","sources":["../../../src/lib/server/product-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,eAAO,MAAM,8BAA8B,EAAE,qBAO5C,CAAC"}

package/dist/lib/server/product-defaults.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Sensible defaults for ReportingCapabilities — a required field on Product
+ * with 6 required sub-fields. Spread into your product definitions:
+ *
+ * @example
+ * ```typescript
+ * const product = {
+ *   product_id: 'display-1',
+ *   name: 'Display Ads',
+ *   reporting_capabilities: DEFAULT_REPORTING_CAPABILITIES,
+ * };
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_REPORTING_CAPABILITIES = void 0;
+exports.DEFAULT_REPORTING_CAPABILITIES = {
+    available_reporting_frequencies: ['daily'],
+    expected_delay_minutes: 240,
+    timezone: 'UTC',
+    supports_webhooks: false,
+    available_metrics: ['impressions', 'spend', 'clicks'],
+    date_range_support: 'date_range',
+};
+//# sourceMappingURL=product-defaults.js.map

package/dist/lib/server/product-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-defaults.js","sourceRoot":"","sources":["../../../src/lib/server/product-defaults.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIU,QAAA,8BAA8B,GAA0B;IACnE,+BAA+B,EAAE,CAAC,OAAO,CAAC;IAC1C,sBAAsB,EAAE,GAAG;IAC3B,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;IACrD,kBAAkB,EAAE,YAAY;CACjC,CAAC"}