@codeqr/ts-mcp 0.9.0 → 0.24.0

package/src/tools/domains/update-domains.ts

@@ -1,79 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { isJqError, maybeFilter } from '@codeqr/ts-mcp/filtering';
-import { Metadata, asErrorResult, asTextContentResult } from '@codeqr/ts-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Codeqr from '@codeqr/ts';
-
-export const metadata: Metadata = {
-  resource: 'domains',
-  operation: 'write',
-  tags: [],
-  httpMethod: 'patch',
-  httpPath: '/domains/{slug}',
-  operationId: 'updateDomain',
-};
-
-export const tool: Tool = {
-  name: 'update_domains',
-  description:
-    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdate a domain for the authenticated workspace.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/domain',\n  $defs: {\n    domain: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'The unique identifier of the domain.'\n        },\n        archived: {\n          type: 'boolean',\n          description: 'Whether the domain is archived.'\n        },\n        createdAt: {\n          type: 'string',\n          description: 'The date the domain was created.'\n        },\n        expiredUrl: {\n          type: 'string',\n          description: 'The URL to redirect to when a link under this domain has expired.'\n        },\n        placeholder: {\n          type: 'string',\n          description: 'Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened.'\n        },\n        primary: {\n          type: 'boolean',\n          description: 'Whether the domain is the primary domain for the project.'\n        },\n        slug: {\n          type: 'string',\n          description: 'The domain name.'\n        },\n        target: {\n          type: 'string',\n          description: 'The target URL to redirect to when accessing the domain root.'\n        },\n        type: {\n          type: 'string',\n          description: 'The behavior type for the domain root redirect.',\n          enum: [            'redirect',\n            'rewrite'\n          ]\n        },\n        updatedAt: {\n          type: 'string',\n          description: 'The date the domain was last updated.'\n        },\n        verified: {\n          type: 'boolean',\n          description: 'Whether the domain is verified.'\n        }\n      },\n      required: [        'id',\n        'archived',\n        'createdAt',\n        'expiredUrl',\n        'placeholder',\n        'primary',\n        'slug',\n        'target',\n        'type',\n        'updatedAt',\n        'verified'\n      ]\n    }\n  }\n}\n```",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      path_slug: {
-        type: 'string',
-        description: 'The domain name.',
-      },
-      archived: {
-        type: 'boolean',
-        description: 'Whether to archive this domain. `false` will unarchive a previously archived domain.',
-      },
-      expiredUrl: {
-        type: 'string',
-        description: 'Redirect users to a specific URL when any link under this domain has expired.',
-      },
-      placeholder: {
-        type: 'string',
-        description:
-          'Provide context to your teammates in the link creation modal by showing them an example of a link to be shortened.',
-      },
-      body_slug: {
-        type: 'string',
-        description: 'Name of the domain.',
-      },
-      target: {
-        type: 'string',
-        description: 'The target URL to redirect to when accessing the domain root.',
-      },
-      type: {
-        type: 'string',
-        description: 'The behavior type for the domain root redirect.',
-        enum: ['redirect', 'rewrite'],
-      },
-      jq_filter: {
-        type: 'string',
-        title: 'jq Filter',
-        description:
-          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
-      },
-    },
-    required: ['path_slug'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: Codeqr, args: Record<string, unknown> | undefined) => {
-  const { slug, jq_filter, ...body } = args as any;
-  try {
-    return asTextContentResult(await maybeFilter(jq_filter, await client.domains.update(slug, body)));
-  } catch (error) {
-    if (error instanceof Codeqr.APIError || isJqError(error)) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/events/list-events.ts

@@ -1,421 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asErrorResult, asTextContentResult } from '@codeqr/ts-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import Codeqr from '@codeqr/ts';
-
-export const metadata: Metadata = {
-  resource: 'events',
-  operation: 'read',
-  tags: [],
-  httpMethod: 'get',
-  httpPath: '/events',
-  operationId: 'listEvents',
-};
-
-export const tool: Tool = {
-  name: 'list_events',
-  description: 'Retrieve a paginated list of events for the authenticated workspace.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      browser: {
-        type: 'string',
-        description: 'The browser to retrieve analytics for.',
-      },
-      city: {
-        type: 'string',
-        description: 'The city to retrieve analytics for.',
-      },
-      continent: {
-        $ref: '#/$defs/continent_code',
-      },
-      country: {
-        $ref: '#/$defs/country_code',
-      },
-      device: {
-        type: 'string',
-        description: 'The device to retrieve analytics for.',
-      },
-      domain: {
-        type: 'string',
-        description: 'The domain of the short link.',
-      },
-      end: {
-        type: 'string',
-        description:
-          'The end date and time when to retrieve analytics from. If not provided, defaults to the current date.',
-      },
-      event: {
-        type: 'string',
-        description: "The type of event to retrieve analytics for. Defaults to 'clicks'.",
-        enum: ['clicks', 'leads', 'sales', 'scans', 'views'],
-      },
-      excludeRoot: {
-        type: 'boolean',
-        description: 'Whether to exclude the root link from the response.',
-      },
-      externalId: {
-        type: 'string',
-        description:
-          "This is the ID of the link in the your database. Must be prefixed with 'ext_' when passed as a query parameter.",
-      },
-      interval: {
-        type: 'string',
-        description:
-          'The interval to retrieve events for. Takes precedence over start and end. If undefined, defaults to 24h.',
-        enum: ['24h', '7d', '30d', '90d', 'ytd', '1y', 'all'],
-      },
-      key: {
-        type: 'string',
-        description: 'The short link slug.',
-      },
-      limit: {
-        type: 'number',
-      },
-      linkId: {
-        type: 'string',
-        description: 'The unique ID of the short link on CodeQR.',
-      },
-      order: {
-        type: 'string',
-        enum: ['asc', 'desc'],
-      },
-      os: {
-        type: 'string',
-        description: 'The OS to retrieve analytics for.',
-      },
-      page: {
-        type: 'number',
-      },
-      pageId: {
-        type: 'string',
-        description: 'The unique ID of the page on CodeQR.',
-      },
-      qrcodeId: {
-        type: 'string',
-        description: 'The unique ID of the QR code on CodeQR.',
-      },
-      referer: {
-        type: 'string',
-        description: 'The referer to retrieve analytics for.',
-      },
-      root: {
-        type: 'boolean',
-        description:
-          'Filter for root domains. If true, filter for domains only. If false, filter for links only. If undefined, return both.',
-      },
-      sortBy: {
-        type: 'string',
-        enum: ['timestamp'],
-      },
-      start: {
-        type: 'string',
-        description: 'The start date and time when to retrieve analytics from.',
-      },
-      tagId: {
-        type: 'string',
-        description: 'The tag ID to retrieve analytics for.',
-      },
-      timezone: {
-        type: 'string',
-        description:
-          'The IANA time zone code for aligning timeseries granularity (e.g. America/New_York). Defaults to UTC.',
-      },
-      type: {
-        type: 'string',
-        description: 'The type of analytics to retrieve.',
-      },
-      types: {
-        type: 'string',
-        description: 'The types of analytics to retrieve.',
-      },
-      url: {
-        type: 'string',
-        description: 'The URL to retrieve analytics for.',
-      },
-    },
-    required: [],
-    $defs: {
-      continent_code: {
-        type: 'string',
-        description: 'The continent to retrieve analytics for.',
-        enum: ['AF', 'AN', 'AS', 'EU', 'NA', 'OC', 'SA'],
-      },
-      country_code: {
-        type: 'string',
-        description: 'The country to retrieve analytics for.',
-        enum: [
-          'AF',
-          'AL',
-          'DZ',
-          'AS',
-          'AD',
-          'AO',
-          'AI',
-          'AQ',
-          'AG',
-          'AR',
-          'AM',
-          'AW',
-          'AU',
-          'AT',
-          'AZ',
-          'BS',
-          'BH',
-          'BD',
-          'BB',
-          'BY',
-          'BE',
-          'BZ',
-          'BJ',
-          'BM',
-          'BT',
-          'BO',
-          'BA',
-          'BW',
-          'BV',
-          'BR',
-          'IO',
-          'BN',
-          'BG',
-          'BF',
-          'BI',
-          'KH',
-          'CM',
-          'CA',
-          'CV',
-          'KY',
-          'CF',
-          'TD',
-          'CL',
-          'CN',
-          'CX',
-          'CC',
-          'CO',
-          'KM',
-          'CG',
-          'CD',
-          'CK',
-          'CR',
-          'CI',
-          'HR',
-          'CU',
-          'CY',
-          'CZ',
-          'DK',
-          'DJ',
-          'DM',
-          'DO',
-          'EC',
-          'EG',
-          'SV',
-          'GQ',
-          'ER',
-          'EE',
-          'ET',
-          'FK',
-          'FO',
-          'FJ',
-          'FI',
-          'FR',
-          'GF',
-          'PF',
-          'TF',
-          'GA',
-          'GM',
-          'GE',
-          'DE',
-          'GH',
-          'GI',
-          'GR',
-          'GL',
-          'GD',
-          'GP',
-          'GU',
-          'GT',
-          'GN',
-          'GW',
-          'GY',
-          'HT',
-          'HM',
-          'VA',
-          'HN',
-          'HK',
-          'HU',
-          'IS',
-          'IN',
-          'ID',
-          'IR',
-          'IQ',
-          'IE',
-          'IL',
-          'IT',
-          'JM',
-          'JP',
-          'JO',
-          'KZ',
-          'KE',
-          'KI',
-          'KP',
-          'KR',
-          'KW',
-          'KG',
-          'LA',
-          'LV',
-          'LB',
-          'LS',
-          'LR',
-          'LY',
-          'LI',
-          'LT',
-          'LU',
-          'MO',
-          'MG',
-          'MW',
-          'MY',
-          'MV',
-          'ML',
-          'MT',
-          'MH',
-          'MQ',
-          'MR',
-          'MU',
-          'YT',
-          'MX',
-          'FM',
-          'MD',
-          'MC',
-          'MN',
-          'MS',
-          'MA',
-          'MZ',
-          'MM',
-          'NA',
-          'NR',
-          'NP',
-          'NL',
-          'NC',
-          'NZ',
-          'NI',
-          'NE',
-          'NG',
-          'NU',
-          'NF',
-          'MK',
-          'MP',
-          'NO',
-          'OM',
-          'PK',
-          'PW',
-          'PS',
-          'PA',
-          'PG',
-          'PY',
-          'PE',
-          'PH',
-          'PN',
-          'PL',
-          'PT',
-          'PR',
-          'QA',
-          'RE',
-          'RO',
-          'RU',
-          'RW',
-          'SH',
-          'KN',
-          'LC',
-          'PM',
-          'VC',
-          'WS',
-          'SM',
-          'ST',
-          'SA',
-          'SN',
-          'SC',
-          'SL',
-          'SG',
-          'SK',
-          'SI',
-          'SB',
-          'SO',
-          'ZA',
-          'GS',
-          'ES',
-          'LK',
-          'SD',
-          'SR',
-          'SJ',
-          'SZ',
-          'SE',
-          'CH',
-          'SY',
-          'TW',
-          'TJ',
-          'TZ',
-          'TH',
-          'TL',
-          'TG',
-          'TK',
-          'TO',
-          'TT',
-          'TN',
-          'TR',
-          'TM',
-          'TC',
-          'TV',
-          'UG',
-          'UA',
-          'AE',
-          'GB',
-          'US',
-          'UM',
-          'UY',
-          'UZ',
-          'VU',
-          'VE',
-          'VN',
-          'VG',
-          'VI',
-          'WF',
-          'EH',
-          'YE',
-          'ZM',
-          'ZW',
-          'AX',
-          'BQ',
-          'CW',
-          'GG',
-          'IM',
-          'JE',
-          'ME',
-          'BL',
-          'MF',
-          'RS',
-          'SX',
-          'SS',
-          'XK',
-        ],
-      },
-    },
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: Codeqr, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  try {
-    return asTextContentResult(await client.events.list(body));
-  } catch (error) {
-    if (error instanceof Codeqr.APIError) {
-      return asErrorResult(error.message);
-    }
-    throw error;
-  }
-};
-
-export default { metadata, tool, handler };

package/src/tools/index.ts

@@ -1,133 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, Endpoint, HandlerFunction } from './types';
-
-export { Metadata, Endpoint, HandlerFunction };
-
-import create_links from './links/create-links';
-import update_links from './links/update-links';
-import list_links from './links/list-links';
-import delete_links from './links/delete-links';
-import count_links from './links/count-links';
-import retrieve_info_links from './links/retrieve-info-links';
-import upsert_links from './links/upsert-links';
-import create_links_bulk from './links/bulk/create-links-bulk';
-import delete_links_bulk from './links/bulk/delete-links-bulk';
-import create_qrcodes from './qrcodes/create-qrcodes';
-import retrieve_qrcodes from './qrcodes/retrieve-qrcodes';
-import update_qrcodes from './qrcodes/update-qrcodes';
-import list_qrcodes from './qrcodes/list-qrcodes';
-import delete_qrcodes from './qrcodes/delete-qrcodes';
-import count_qrcodes from './qrcodes/count-qrcodes';
-import upsert_qrcodes from './qrcodes/upsert-qrcodes';
-import create_qrcodes_bulk from './qrcodes/bulk/create-qrcodes-bulk';
-import delete_qrcodes_bulk from './qrcodes/bulk/delete-qrcodes-bulk';
-import retrieve_analytics from './analytics/retrieve-analytics';
-import list_events from './events/list-events';
-import create_tags from './tags/create-tags';
-import update_tags from './tags/update-tags';
-import list_tags from './tags/list-tags';
-import delete_tags from './tags/delete-tags';
-import create_domains from './domains/create-domains';
-import update_domains from './domains/update-domains';
-import list_domains from './domains/list-domains';
-import delete_domains from './domains/delete-domains';
-import track_lead_track from './track/track-lead-track';
-import track_sale_track from './track/track-sale-track';
-import retrieve_projects from './projects/retrieve-projects';
-import list_projects from './projects/list-projects';
-
-export const endpoints: Endpoint[] = [];
-
-function addEndpoint(endpoint: Endpoint) {
-  endpoints.push(endpoint);
-}
-
-addEndpoint(create_links);
-addEndpoint(update_links);
-addEndpoint(list_links);
-addEndpoint(delete_links);
-addEndpoint(count_links);
-addEndpoint(retrieve_info_links);
-addEndpoint(upsert_links);
-addEndpoint(create_links_bulk);
-addEndpoint(delete_links_bulk);
-addEndpoint(create_qrcodes);
-addEndpoint(retrieve_qrcodes);
-addEndpoint(update_qrcodes);
-addEndpoint(list_qrcodes);
-addEndpoint(delete_qrcodes);
-addEndpoint(count_qrcodes);
-addEndpoint(upsert_qrcodes);
-addEndpoint(create_qrcodes_bulk);
-addEndpoint(delete_qrcodes_bulk);
-addEndpoint(retrieve_analytics);
-addEndpoint(list_events);
-addEndpoint(create_tags);
-addEndpoint(update_tags);
-addEndpoint(list_tags);
-addEndpoint(delete_tags);
-addEndpoint(create_domains);
-addEndpoint(update_domains);
-addEndpoint(list_domains);
-addEndpoint(delete_domains);
-addEndpoint(track_lead_track);
-addEndpoint(track_sale_track);
-addEndpoint(retrieve_projects);
-addEndpoint(list_projects);
-
-export type Filter = {
-  type: 'resource' | 'operation' | 'tag' | 'tool';
-  op: 'include' | 'exclude';
-  value: string;
-};
-
-export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
-  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
-  const unmatchedFilters = new Set(filters);
-
-  const filtered = endpoints.filter((endpoint: Endpoint) => {
-    let included = false || allExcludes;
-
-    for (const filter of filters) {
-      if (match(filter, endpoint)) {
-        unmatchedFilters.delete(filter);
-        included = filter.op === 'include';
-      }
-    }
-
-    return included;
-  });
-
-  // Check if any filters didn't match
-  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
-  if (unmatched.length > 0) {
-    throw new Error(
-      `The following filters did not match any endpoints: ${unmatched
-        .map((f) => `${f.type}=${f.value}`)
-        .join(', ')}`,
-    );
-  }
-
-  return filtered;
-}
-
-function match({ type, value }: Filter, endpoint: Endpoint): boolean {
-  switch (type) {
-    case 'resource': {
-      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
-      const regex = new RegExp(regexStr);
-      return regex.test(normalizeResource(endpoint.metadata.resource));
-    }
-    case 'operation':
-      return endpoint.metadata.operation === value;
-    case 'tag':
-      return endpoint.metadata.tags.includes(value);
-    case 'tool':
-      return endpoint.tool.name === value;
-  }
-}
-
-function normalizeResource(resource: string): string {
-  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
-}