@vibesdotdev/integrations-miro 0.0.0-stage → 1.0.0-rc.0

package/dist/miro/miro-client.d.ts

@@ -0,0 +1,22 @@
+import { type MiroClientConfig } from '../schemas/http.ts';
+import { type CreateMiroBoardInput, type CreateMiroItemInput, type DeleteMiroItemResult, type MiroBoard, type MiroBoardIdInput, type MiroBoardListOptions, type MiroBoardListResult, type MiroBoardUpdateResult, type MiroItem, type MiroItemIdInput, type MiroItemListOptions, type MiroItemListResult, type UpdateMiroBoardInput, type UpdateMiroItemInput } from './miro-schemas.ts';
+export { MiroAPIError } from './errors.ts';
+export type { MiroFetch, MiroClientConfig } from '../schemas/http.ts';
+/** Typed, bounded transport for Miro REST API v2. */
+export declare class MiroAPIClient {
+    private readonly apiToken;
+    private readonly fetchFn;
+    constructor(config: MiroClientConfig);
+    listBoards(options?: MiroBoardListOptions): Promise<MiroBoardListResult>;
+    getBoard(input: MiroBoardIdInput | string): Promise<MiroBoard | null>;
+    createBoard(input: CreateMiroBoardInput): Promise<MiroBoard>;
+    updateBoard(input: UpdateMiroBoardInput): Promise<MiroBoardUpdateResult>;
+    listItems(options: MiroItemListOptions): Promise<MiroItemListResult>;
+    getItem(input: MiroItemIdInput): Promise<MiroItem | null>;
+    createItem(input: CreateMiroItemInput): Promise<MiroItem>;
+    updateItem(input: UpdateMiroItemInput): Promise<MiroItem>;
+    deleteItem(input: MiroItemIdInput): Promise<DeleteMiroItemResult>;
+    private request;
+    private requestResult;
+}
+//# sourceMappingURL=miro-client.d.ts.map

package/dist/miro/miro-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miro-client.d.ts","sourceRoot":"","sources":["../../src/miro/miro-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoF,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG7I,OAAO,EAeN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAGvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,qDAAqD;AACrD,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;gBAExB,MAAM,EAAE,gBAAgB;IAO9B,UAAU,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB5E,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAUrE,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAO5D,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyBxE,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgBpE,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAczD,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzD,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;YASzD,OAAO;YAOP,aAAa;CAgC3B"}

package/dist/miro/miro-client.js

@@ -0,0 +1,225 @@
+import { CapabilityError, valueFreeFailure, settle } from '@vibesdotdev/kernel';
+import { MiroAPIError } from "./errors.js";
+import { RawMiroListSchema, MiroBoardLookupSchema, MiroClientConfigSchema } from "../schemas/http.js";
+import { MiroJsonValueSchema, MiroJsonRecordSchema } from "../schemas/miro.js";
+import { parseMiroBoundary, parseMiroResponse } from "../schemas/operations.js";
+import { CreateMiroBoardInputSchema, CreateMiroItemInputSchema, DeleteMiroItemResultSchema, MiroBoardListOptionsSchema, MiroBoardListResultSchema, MiroBoardSchema, MiroBoardUpdateResultSchema, MiroItemIdInputSchema, MiroItemListOptionsSchema, MiroItemListResultSchema, MiroItemSchema, MiroRateLimitMetadataSchema, UpdateMiroBoardInputSchema, UpdateMiroItemInputSchema } from "./miro-schemas.js";
+const MIRO_API_BASE = 'https://api.miro.com/v2';
+const ITEM_ENDPOINTS = {
+    card: 'cards', shape: 'shapes', sticky_note: 'sticky_notes', text: 'texts'
+};
+export { MiroAPIError } from "./errors.js";
+/** Typed, bounded transport for Miro REST API v2. */
+export class MiroAPIClient {
+    apiToken;
+    fetchFn;
+    constructor(config) {
+        const parsed = MiroClientConfigSchema.safeParse(config);
+        if (!parsed.success)
+            throw new MiroAPIError('Miro token is required.', { reason: 'miro-token-required' });
+        this.apiToken = parsed.data.apiToken;
+        this.fetchFn = parsed.data.fetchFn ?? fetch;
+    }
+    async listBoards(options = {}) {
+        const input = parseMiroBoundary(MiroBoardListOptionsSchema, options);
+        const params = new URLSearchParams({
+            limit: String(input.limit),
+            offset: String(input.offset)
+        });
+        setParam(params, 'team_id', input.teamId);
+        setParam(params, 'project_id', input.projectId);
+        setParam(params, 'query', input.query);
+        setParam(params, 'owner', input.owner);
+        setParam(params, 'sort', input.sort);
+        const raw = parseMiroResponse(RawMiroListSchema, await this.request(`/boards?${params.toString()}`));
+        return parseMiroResponse(MiroBoardListResultSchema, {
+            boards: raw.data.map((board) => parseMiroResponse(MiroBoardSchema, board)),
+            size: raw.size ?? raw.data.length,
+            limit: raw.limit ?? input.limit,
+            offset: raw.offset ?? input.offset,
+            total: raw.total
+        });
+    }
+    async getBoard(input) {
+        const { boardId } = parseMiroBoundary(MiroBoardLookupSchema, input);
+        try {
+            return parseMiroResponse(MiroBoardSchema, await this.request(`/boards/${encodeURIComponent(boardId)}`));
+        }
+        catch (error) {
+            if (error instanceof MiroAPIError && error.code === 'NOT_FOUND' && error.reason === 'record-absent' && error.details?.failure === undefined)
+                return null;
+            throw error;
+        }
+    }
+    async createBoard(input) {
+        const request = parseMiroBoundary(CreateMiroBoardInputSchema, input);
+        return parseMiroResponse(MiroBoardSchema, await this.request('/boards', { method: 'POST', body: mutableBoardBody(request) }));
+    }
+    async updateBoard(input) {
+        const request = parseMiroBoundary(UpdateMiroBoardInputSchema, input);
+        const result = await this.requestResult(`/boards/${encodeURIComponent(request.boardId)}`, {
+            method: 'PATCH',
+            body: mutableBoardBody(request)
+        });
+        if (result.status !== 202) {
+            return parseMiroResponse(MiroBoardUpdateResultSchema, {
+                boardId: request.boardId,
+                state: 'completed',
+                board: parseMiroResponse(MiroBoardSchema, result.data),
+                pendingFields: []
+            });
+        }
+        const board = await this.getBoard(request.boardId);
+        const pendingFields = board ? pendingBoardFields(board, request) : mutableBoardFieldNames(request);
+        return parseMiroResponse(MiroBoardUpdateResultSchema, {
+            boardId: request.boardId,
+            state: pendingFields.length === 0 ? 'completed' : 'accepted',
+            board: board ?? undefined,
+            pendingFields
+        });
+    }
+    async listItems(options) {
+        const input = parseMiroBoundary(MiroItemListOptionsSchema, options);
+        const params = new URLSearchParams({ limit: String(input.limit) });
+        setParam(params, 'cursor', input.cursor);
+        setParam(params, 'type', input.type);
+        const raw = parseMiroResponse(RawMiroListSchema, await this.request(`/boards/${encodeURIComponent(input.boardId)}/items?${params.toString()}`));
+        return parseMiroResponse(MiroItemListResultSchema, {
+            items: raw.data.map((item) => parseMiroResponse(MiroItemSchema, item)),
+            hasMore: Boolean(raw.cursor),
+            nextCursor: raw.cursor
+        });
+    }
+    async getItem(input) {
+        const request = parseMiroBoundary(MiroItemIdInputSchema, input);
+        try {
+            return parseMiroResponse(MiroItemSchema, await this.request(`/boards/${encodeURIComponent(request.boardId)}/items/${encodeURIComponent(request.itemId)}`));
+        }
+        catch (error) {
+            if (error instanceof MiroAPIError && error.code === 'NOT_FOUND' && error.reason === 'record-absent' && error.details?.failure === undefined)
+                return null;
+            throw error;
+        }
+    }
+    async createItem(input) {
+        const request = parseMiroBoundary(CreateMiroItemInputSchema, input);
+        const endpoint = ITEM_ENDPOINTS[request.type];
+        return parseMiroResponse(MiroItemSchema, await this.request(`/boards/${encodeURIComponent(request.boardId)}/${endpoint}`, {
+            method: 'POST',
+            body: mutableItemBody(request)
+        }));
+    }
+    async updateItem(input) {
+        const request = parseMiroBoundary(UpdateMiroItemInputSchema, input);
+        const endpoint = ITEM_ENDPOINTS[request.type];
+        return parseMiroResponse(MiroItemSchema, await this.request(`/boards/${encodeURIComponent(request.boardId)}/${endpoint}/${encodeURIComponent(request.itemId)}`, { method: 'PATCH', body: mutableItemBody(request) }));
+    }
+    async deleteItem(input) {
+        const request = parseMiroBoundary(MiroItemIdInputSchema, input);
+        await this.request(`/boards/${encodeURIComponent(request.boardId)}/items/${encodeURIComponent(request.itemId)}`, { method: 'DELETE' });
+        return parseMiroResponse(DeleteMiroItemResultSchema, { deleted: true, itemId: request.itemId });
+    }
+    async request(path, options = {}) {
+        return (await this.requestResult(path, options)).data;
+    }
+    async requestResult(path, options = {}) {
+        const headers = new Headers({ Accept: 'application/json' });
+        if (this.apiToken !== undefined) {
+            headers.set('Authorization', `Bearer ${this.apiToken}`);
+        }
+        if (options.body)
+            headers.set('Content-Type', 'application/json');
+        const attempt = await settle(() => this.fetchFn(`${MIRO_API_BASE}${path}`, {
+            method: options.method ?? 'GET', headers,
+            body: options.body ? JSON.stringify(options.body) : undefined
+        }));
+        if (!attempt.ok) {
+            if (attempt.cause instanceof CapabilityError)
+                throw attempt.cause;
+            throw new MiroAPIError('Miro transport failed.', {
+                reason: 'miro-transport-failed', failure: valueFreeFailure(attempt.cause)
+            });
+        }
+        const response = attempt.value;
+        if (!response.ok) {
+            const released = await settle(() => response.body?.cancel());
+            throw new MiroAPIError('Miro request failed.', {
+                status: response.status, rateLimit: rateLimitMetadata(response.headers),
+                failure: released.ok ? undefined : valueFreeFailure(released.cause)
+            });
+        }
+        if (response.status === 204)
+            return { status: response.status, data: undefined };
+        const payload = await readJson(response);
+        return { status: response.status, data: payload };
+    }
+}
+function mutableItemBody(input) {
+    return parseMiroBoundary(MiroJsonRecordSchema, Object.fromEntries(Object.entries({
+        data: input.data, style: input.style, position: input.position,
+        geometry: input.geometry, parent: input.parent
+    }).filter(([, value]) => value !== undefined)));
+}
+function mutableBoardBody(input) {
+    return parseMiroBoundary(MiroJsonRecordSchema, Object.fromEntries(Object.entries({
+        name: input.name, description: input.description, teamId: input.teamId, projectId: input.projectId
+    }).filter(([, value]) => value !== undefined)));
+}
+function mutableBoardFieldNames(input) {
+    return ['name', 'description', 'teamId', 'projectId'].filter((field) => input[field] !== undefined);
+}
+function pendingBoardFields(board, input) {
+    return mutableBoardFieldNames(input).filter((field) => {
+        switch (field) {
+            case 'name':
+                return board.name !== input.name;
+            case 'description':
+                return (board.description ?? '') !== input.description;
+            case 'teamId':
+                return board.team?.id !== input.teamId;
+            case 'projectId':
+                return board.project?.id !== input.projectId;
+        }
+    });
+}
+async function readJson(response) {
+    const attempt = await settle(async () => {
+        const text = await response.text();
+        if (text.length === 0)
+            return undefined;
+        return parseMiroResponse(MiroJsonValueSchema, JSON.parse(text));
+    });
+    if (!attempt.ok) {
+        if (attempt.cause instanceof CapabilityError)
+            throw attempt.cause;
+        throw new MiroAPIError('Miro response is invalid.', {
+            failure: valueFreeFailure(attempt.cause),
+            status: response.status, reason: 'miro-response-invalid',
+            rateLimit: rateLimitMetadata(response.headers)
+        });
+    }
+    return attempt.value;
+}
+function rateLimitMetadata(headers) {
+    const candidate = {
+        limitCredits: headerNumber(headers, 'X-RateLimit-Limit'),
+        remainingCredits: headerNumber(headers, 'X-RateLimit-Remaining'),
+        resetAt: headerNumber(headers, 'X-RateLimit-Reset'),
+        retryAfterSeconds: headerNumber(headers, 'Retry-After')
+    };
+    if (Object.values(candidate).every((value) => value === undefined))
+        return undefined;
+    return MiroRateLimitMetadataSchema.parse(candidate);
+}
+function headerNumber(headers, name) {
+    const raw = headers.get(name);
+    if (raw === null || raw.trim().length === 0)
+        return undefined;
+    const value = Number(raw);
+    return Number.isFinite(value) && value >= 0 ? value : undefined;
+}
+function setParam(params, key, value) {
+    if (value !== undefined)
+        params.set(key, value);
+}
+//# sourceMappingURL=miro-client.js.map

package/dist/miro/miro-client.js.map

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

package/dist/miro/miro-implementation.d.ts

@@ -0,0 +1,17 @@
+import { type MiroOperationInput } from '../schemas/operations.ts';
+import type { IntegrationConnectionSelector, IntegrationOAuthAuthorization, IntegrationOAuthCompletion, IntegrationOAuthStart, IntegrationOperationResult } from '@vibesdotdev/integrations/schemas/integration-descriptor';
+import { BaseIntegrationProvider } from '@vibesdotdev/integrations/kinds/integration';
+import { MiroAPIClient } from './miro-client.ts';
+import { type MiroPullOptions, type MiroPullResult } from './miro-schemas.ts';
+/** Hosted Miro integration provider. */
+export declare class MiroIntegration extends BaseIntegrationProvider {
+    startAuthorization(_input: IntegrationOAuthStart): Promise<IntegrationOAuthAuthorization>;
+    completeAuthorization(_input: IntegrationOAuthCompletion): Promise<void>;
+    invokeOperation<T = unknown>(opId: string, args?: MiroOperationInput): Promise<IntegrationOperationResult<T>>;
+    invokeOperationForConnection<T = unknown>(selector: Readonly<IntegrationConnectionSelector>, opId: string, args?: MiroOperationInput): Promise<IntegrationOperationResult<T>>;
+    private dispatch;
+    getClient(selector?: Readonly<IntegrationConnectionSelector>): Promise<MiroAPIClient>;
+    /** Pull one page only; cursor persistence and mapping belong to the sync owner. */
+    pullBoardItems(options: MiroPullOptions, selector?: Readonly<IntegrationConnectionSelector>): Promise<MiroPullResult>;
+}
+//# sourceMappingURL=miro-implementation.d.ts.map

package/dist/miro/miro-implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miro-implementation.d.ts","sourceRoot":"","sources":["../../src/miro/miro-implementation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,kBAAkB,EAA+C,MAAM,0BAA0B,CAAC;AAChH,OAAO,KAAK,EACX,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAUN,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,qBAAa,eAAgB,SAAQ,uBAAuB;IAE5C,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,6BAA6B,CAAC;IAI1B,qBAAqB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAKtH,4BAA4B,CAAC,CAAC,GAAG,OAAO,EACvC,QAAQ,EAAE,QAAQ,CAAC,6BAA6B,CAAC,EACjD,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;YAS3B,QAAQ;IAmDhB,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC3F,mFAAmF;IAC7E,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,6BAA6B,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAU3H"}

package/dist/miro/miro-implementation.js

@@ -0,0 +1,108 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { parseMiroBoundary } from "../schemas/operations.js";
+import { BaseIntegrationProvider } from '@vibesdotdev/integrations/kinds/integration';
+import { MiroAPIClient } from "./miro-client.js";
+import { sendIntegrationAuthenticatedRequest } from '@vibesdotdev/integrations/server/secrets';
+import { CreateMiroBoardInputSchema, CreateMiroItemInputSchema, MiroBoardIdInputSchema, MiroBoardListOptionsSchema, MiroItemIdInputSchema, MiroItemListOptionsSchema, MiroPullOptionsSchema, UpdateMiroBoardInputSchema, UpdateMiroItemInputSchema } from "./miro-schemas.js";
+/** Hosted Miro integration provider. */
+export class MiroIntegration extends BaseIntegrationProvider {
+    async startAuthorization(_input) {
+        throw new CapabilityError('Miro OAuth is owned by the platform host.', 'UNAVAILABLE', { reason: 'miro-oauth-host-required' });
+    }
+    async completeAuthorization(_input) {
+        throw new CapabilityError('Miro OAuth is owned by the platform host.', 'UNAVAILABLE', { reason: 'miro-oauth-host-required' });
+    }
+    async invokeOperation(opId, args) {
+        return this.dispatch(opId, args);
+    }
+    async invokeOperationForConnection(selector, opId, args) {
+        return this.dispatch(opId, args, selector);
+    }
+    async dispatch(opId, args, selector) {
+        const declared = (this.descriptor.operations ?? []).some((operation) => operation.id === opId);
+        if (!declared) {
+            throw new CapabilityError('Miro does not declare this operation.', 'INVALID_INPUT', { reason: 'miro-operation-undeclared' });
+        }
+        const client = await this.getClient(selector);
+        let data;
+        switch (opId) {
+            case 'listBoards':
+                data = await client.listBoards(parseMiroBoundary(MiroBoardListOptionsSchema, args ?? {}));
+                break;
+            case 'getBoard':
+                data = await client.getBoard(parseMiroBoundary(MiroBoardIdInputSchema, args));
+                break;
+            case 'createBoard':
+                data = await client.createBoard(parseMiroBoundary(CreateMiroBoardInputSchema, args));
+                break;
+            case 'updateBoard':
+                data = await client.updateBoard(parseMiroBoundary(UpdateMiroBoardInputSchema, args));
+                break;
+            case 'listItems':
+                data = await client.listItems(parseMiroBoundary(MiroItemListOptionsSchema, args));
+                break;
+            case 'getItem':
+                data = await client.getItem(parseMiroBoundary(MiroItemIdInputSchema, args));
+                break;
+            case 'createItem':
+                data = await client.createItem(parseMiroBoundary(CreateMiroItemInputSchema, args));
+                break;
+            case 'updateItem':
+                data = await client.updateItem(parseMiroBoundary(UpdateMiroItemInputSchema, args));
+                break;
+            case 'deleteItem':
+                data = await client.deleteItem(parseMiroBoundary(MiroItemIdInputSchema, args));
+                break;
+            case 'pull-board-items':
+                data = await this.pullBoardItems(parseMiroBoundary(MiroPullOptionsSchema, args), selector);
+                break;
+            default:
+                throw new CapabilityError('Miro operation is not implemented.', 'INVALID_INPUT', { reason: 'miro-operation-undeclared' });
+        }
+        return { ok: true, data };
+    }
+    async getClient(selector) {
+        const runtime = this.context.runtime;
+        if (!runtime) {
+            throw new CapabilityError('Miro runtime is required.', 'UNAVAILABLE', { reason: 'miro-runtime-required' });
+        }
+        const resolved = await this.getCredentialUseConfiguration(selector);
+        const candidates = resolved.credentialReferences.accessToken ?? [];
+        if (candidates.length === 0) {
+            throw new CapabilityError('Miro access credential is required.', 'PERMISSION_DENIED', { reason: 'miro-token-required' });
+        }
+        return new MiroAPIClient({ fetchFn: async (input, init) => {
+                const request = new Request(input, init);
+                const method = request.method;
+                if (method !== 'GET' && method !== 'POST' && method !== 'PUT' && method !== 'PATCH' && method !== 'DELETE') {
+                    throw new CapabilityError('Miro request method is unsupported.', 'INVALID_INPUT', { reason: 'miro-request-method-invalid' });
+                }
+                const textBody = z.string().safeParse(init?.body);
+                return sendIntegrationAuthenticatedRequest(runtime, {
+                    url: request.url,
+                    signal: request.signal,
+                    options: {
+                        method,
+                        headers: Object.fromEntries(request.headers),
+                        body: textBody.success ? textBody.data : request.body ?? undefined,
+                        credentialBindings: [{
+                                kind: 'header', candidates, header: 'authorization', prefix: 'Bearer '
+                            }]
+                    }
+                });
+            } });
+    }
+    /** Pull one page only; cursor persistence and mapping belong to the sync owner. */
+    async pullBoardItems(options, selector) {
+        const request = parseMiroBoundary(MiroPullOptionsSchema, options);
+        const response = await (await this.getClient(selector)).listItems(request);
+        return {
+            items: response.items,
+            hasMore: response.hasMore,
+            nextCursor: response.nextCursor,
+            scanned: response.items.length
+        };
+    }
+}
+//# sourceMappingURL=miro-implementation.js.map

package/dist/miro/miro-implementation.js.map

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

package/dist/miro/miro-schemas.d.ts

@@ -0,0 +1,2 @@
+export * from '../schemas/miro.ts';
+//# sourceMappingURL=miro-schemas.d.ts.map

package/dist/miro/miro-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miro-schemas.d.ts","sourceRoot":"","sources":["../../src/miro/miro-schemas.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/miro/miro-schemas.js

@@ -0,0 +1,2 @@
+export * from "../schemas/miro.js";
+//# sourceMappingURL=miro-schemas.js.map

package/dist/miro/miro-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miro-schemas.js","sourceRoot":"","sources":["../../src/miro/miro-schemas.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/miro/system.integration.miro.descriptor.d.ts

@@ -0,0 +1,69 @@
+declare const _default: {
+    id: string;
+    kind: "integration/provider";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    capabilityId?: string | undefined;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    provider?: string | undefined;
+    category?: "push" | "email" | "webhook" | "accounting" | "vcs" | "issue-tracker" | "productivity" | "ocr" | "messaging" | "sms" | "storage" | "analytics" | "observability" | "crm" | "calendar" | "other" | undefined;
+    priority?: number | undefined;
+    baseUrl?: string | undefined;
+    config?: Record<string, import("@vibesdotdev/kernel/bootstrap").JsonValue> | undefined;
+    protectedConfigKeys?: string[] | undefined;
+    configurationSource?: "account" | "host" | undefined;
+    configSettingKey?: string | undefined;
+    credentials?: {
+        key: string;
+        source: "secret" | "setting";
+        reference?: {
+            source: "secret";
+            key: string;
+            store?: string | undefined;
+            operation?: object | undefined;
+        } | undefined;
+        providerType?: string | undefined;
+        scope?: "project" | "user" | "platform" | "org" | undefined;
+        scopeId?: string | undefined;
+        settingKey?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+    oauth?: {
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        scopes?: string[] | undefined;
+        authorizationParams?: Record<string, string> | undefined;
+        configFromCallback?: string[] | undefined;
+        clientAuthentication?: "form" | "basic" | undefined;
+        bodyEncoding?: "form" | "json" | undefined;
+        headers?: Record<string, string> | undefined;
+        scopeIdCallbackParam?: string | undefined;
+    } | undefined;
+    operations?: {
+        id: string;
+        name: string;
+        description?: string | undefined;
+        requiresOrg?: boolean | undefined;
+    }[] | undefined;
+    connection?: {
+        authMode?: "oauth" | "webhook" | "delegated" | "system-config" | undefined;
+        connectable?: boolean | undefined;
+        checkable?: boolean | undefined;
+        requiresProviderAdmin?: boolean | undefined;
+    } | undefined;
+};
+export default _default;
+//# sourceMappingURL=system.integration.miro.descriptor.d.ts.map

package/dist/miro/system.integration.miro.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.integration.miro.descriptor.d.ts","sourceRoot":"","sources":["../../src/miro/system.integration.miro.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,wBA4GG"}

package/dist/miro/system.integration.miro.descriptor.js

@@ -0,0 +1,109 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import {} from '@vibesdotdev/integrations/schemas/integration-descriptor';
+export default createRuntimeAsset({
+    kind: 'integration/provider',
+    id: 'integration.miro',
+    name: 'Miro',
+    description: 'Miro v2 boards and board-items transport for domain-owned projections.',
+    provider: 'miro',
+    category: 'productivity',
+    enabled: true,
+    priority: 90,
+    baseUrl: 'https://api.miro.com/v2',
+    configSettingKey: 'integrations.miro.config',
+    config: {
+        teamId: '',
+        boardId: ''
+    },
+    credentials: [
+        {
+            key: 'accessToken',
+            source: 'secret',
+            providerType: 'miro',
+            scope: 'org',
+            required: false
+        },
+        {
+            key: 'accessToken',
+            source: 'secret',
+            reference: { source: 'secret', key: 'MIRO_API_TOKEN' },
+            required: false
+        }
+    ],
+    oauth: {
+        authorizationEndpoint: 'https://miro.com/oauth/authorize',
+        tokenEndpoint: 'https://api.miro.com/v1/oauth/token',
+        scopes: ['boards:read', 'boards:write'],
+        configFromCallback: []
+    },
+    connection: {
+        authMode: 'oauth',
+        connectable: true,
+        checkable: true,
+        requiresProviderAdmin: false
+    },
+    operations: [
+        {
+            id: 'listBoards',
+            name: 'List boards',
+            description: 'List one bounded offset page of boards. Args: `MiroBoardListOptions`.',
+            requiresOrg: true
+        },
+        {
+            id: 'getBoard',
+            name: 'Get board',
+            description: 'Fetch a board by id. Args: `{ boardId: string }`.',
+            requiresOrg: true
+        },
+        {
+            id: 'createBoard',
+            name: 'Create board',
+            description: 'Create a board and optionally place it in an explicit team and Space. Args: `CreateMiroBoardInput`.',
+            requiresOrg: true
+        },
+        {
+            id: 'updateBoard',
+            name: 'Update board',
+            description: 'Update a board or move it to an explicit team and Space. Args: `UpdateMiroBoardInput`.',
+            requiresOrg: true
+        },
+        {
+            id: 'listItems',
+            name: 'List board items',
+            description: 'List one bounded cursor page of board items. Args: `MiroItemListOptions`.',
+            requiresOrg: true
+        },
+        {
+            id: 'getItem',
+            name: 'Get board item',
+            description: 'Fetch a board item by id. Args: `{ boardId: string; itemId: string }`.',
+            requiresOrg: true
+        },
+        {
+            id: 'createItem',
+            name: 'Create board item',
+            description: 'Create a supported board item. Args: `CreateMiroItemInput`.',
+            requiresOrg: true
+        },
+        {
+            id: 'updateItem',
+            name: 'Update board item',
+            description: 'Update a supported board item. Args: `UpdateMiroItemInput`.',
+            requiresOrg: true
+        },
+        {
+            id: 'deleteItem',
+            name: 'Delete board item',
+            description: 'Delete a board item. Args: `{ boardId: string; itemId: string }`.',
+            requiresOrg: true
+        },
+        {
+            id: 'pull-board-items',
+            name: 'Pull board items',
+            description: 'Pull exactly one bounded cursor page for a domain-owned sync binding. Args: `MiroPullOptions`.',
+            requiresOrg: true
+        }
+    ],
+    tags: ['system', 'integration', 'miro', 'boards', 'planning', 'sync']
+});
+//# sourceMappingURL=system.integration.miro.descriptor.js.map

package/dist/miro/system.integration.miro.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.integration.miro.descriptor.js","sourceRoot":"","sources":["../../src/miro/system.integration.miro.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAEN,MAAM,0DAA0D,CAAC;AAElE,eAAe,kBAAkB,CAAqC;IACrE,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wEAAwE;IACrF,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,yBAAyB;IAClC,gBAAgB,EAAE,0BAA0B;IAC5C,MAAM,EAAE;QACP,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACX;IACD,WAAW,EAAE;QACZ;YACC,GAAG,EAAE,aAAa;YAClB,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,MAAM;YACpB,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,KAAK;SACf;QACD;YACC,GAAG,EAAE,aAAa;YAClB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;YACtD,QAAQ,EAAE,KAAK;SACf;KACD;IACD,KAAK,EAAE;QACN,qBAAqB,EAAE,kCAAkC;QACzD,aAAa,EAAE,qCAAqC;QACpD,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;QACvC,kBAAkB,EAAE,EAAE;KACtB;IACD,UAAU,EAAE;QACX,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,qBAAqB,EAAE,KAAK;KAC5B;IACD,UAAU,EAAE;QACX;YACC,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,uEAAuE;YACpF,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,mDAAmD;YAChE,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,cAAc;YACpB,WAAW,EACV,qGAAqG;YACtG,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,cAAc;YACpB,WAAW,EACV,wFAAwF;YACzF,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,2EAA2E;YACxF,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,wEAAwE;YACrF,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,6DAA6D;YAC1E,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,6DAA6D;YAC1E,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,mEAAmE;YAChF,WAAW,EAAE,IAAI;SACjB;QACD;YACC,EAAE,EAAE,kBAAkB;YACtB,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACV,gGAAgG;YACjG,WAAW,EAAE,IAAI;SACjB;KACD;IACD,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;CACrE,CAAC,CAAC"}