@squadbase/vite-server 0.1.11-dev.0c78963 → 0.1.12-dev.822582a
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +1281 -43
- package/dist/connectors/outlook-oauth.d.ts +5 -0
- package/dist/connectors/outlook-oauth.js +929 -0
- package/dist/connectors/powerbi-oauth.d.ts +5 -0
- package/dist/connectors/powerbi-oauth.js +720 -0
- package/dist/connectors/tableau.d.ts +5 -0
- package/dist/connectors/tableau.js +879 -0
- package/dist/index.js +1281 -43
- package/dist/main.js +1281 -43
- package/dist/vite-plugin.js +1281 -43
- package/package.json +13 -1
package/dist/cli/index.js
CHANGED
|
@@ -27625,6 +27625,1241 @@ export default async function handler(c: Context) {
|
|
|
27625
27625
|
tools: tools79
|
|
27626
27626
|
});
|
|
27627
27627
|
|
|
27628
|
+
// ../connectors/src/connectors/powerbi-oauth/tools/request.ts
|
|
27629
|
+
import { z as z97 } from "zod";
|
|
27630
|
+
var BASE_HOST12 = "https://api.powerbi.com";
|
|
27631
|
+
var BASE_PATH_SEGMENT15 = "/v1.0/myorg";
|
|
27632
|
+
var BASE_URL41 = `${BASE_HOST12}${BASE_PATH_SEGMENT15}`;
|
|
27633
|
+
var REQUEST_TIMEOUT_MS74 = 6e4;
|
|
27634
|
+
var cachedToken32 = null;
|
|
27635
|
+
async function getProxyToken32(config) {
|
|
27636
|
+
if (cachedToken32 && cachedToken32.expiresAt > Date.now() + 6e4) {
|
|
27637
|
+
return cachedToken32.token;
|
|
27638
|
+
}
|
|
27639
|
+
const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
|
|
27640
|
+
const res = await fetch(url, {
|
|
27641
|
+
method: "POST",
|
|
27642
|
+
headers: {
|
|
27643
|
+
"Content-Type": "application/json",
|
|
27644
|
+
"x-api-key": config.appApiKey,
|
|
27645
|
+
"project-id": config.projectId
|
|
27646
|
+
},
|
|
27647
|
+
body: JSON.stringify({
|
|
27648
|
+
sandboxId: config.sandboxId,
|
|
27649
|
+
issuedBy: "coding-agent"
|
|
27650
|
+
})
|
|
27651
|
+
});
|
|
27652
|
+
if (!res.ok) {
|
|
27653
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
27654
|
+
throw new Error(
|
|
27655
|
+
`Failed to get proxy token: HTTP ${res.status} ${errorText}`
|
|
27656
|
+
);
|
|
27657
|
+
}
|
|
27658
|
+
const data = await res.json();
|
|
27659
|
+
cachedToken32 = {
|
|
27660
|
+
token: data.token,
|
|
27661
|
+
expiresAt: new Date(data.expiresAt).getTime()
|
|
27662
|
+
};
|
|
27663
|
+
return data.token;
|
|
27664
|
+
}
|
|
27665
|
+
var inputSchema97 = z97.object({
|
|
27666
|
+
toolUseIntent: z97.string().optional().describe(
|
|
27667
|
+
"Brief description of what you intend to accomplish with this tool call"
|
|
27668
|
+
),
|
|
27669
|
+
connectionId: z97.string().describe("ID of the Power BI OAuth connection to use"),
|
|
27670
|
+
method: z97.enum(["GET", "POST", "PATCH", "PUT", "DELETE"]).describe(
|
|
27671
|
+
"HTTP method. GET for reading workspaces/datasets/reports, POST for executeQueries / refresh, PATCH/PUT for updates, DELETE for removal."
|
|
27672
|
+
),
|
|
27673
|
+
path: z97.string().describe(
|
|
27674
|
+
"API path appended to https://api.powerbi.com/v1.0/myorg (e.g., '/groups', '/groups/{groupId}/datasets'). The authenticated user must have access to the workspace."
|
|
27675
|
+
),
|
|
27676
|
+
queryParams: z97.record(z97.string(), z97.string()).optional().describe(
|
|
27677
|
+
`Query parameters to append (e.g., { $top: '50', $filter: "name eq 'Sales'" }).`
|
|
27678
|
+
),
|
|
27679
|
+
body: z97.record(z97.string(), z97.unknown()).optional().describe(
|
|
27680
|
+
"JSON request body for POST/PATCH/PUT/DELETE. Example executeQueries body: { queries: [{ query: 'EVALUATE TOPN(10, Sales)' }], serializerSettings: { includeNulls: true } }."
|
|
27681
|
+
)
|
|
27682
|
+
});
|
|
27683
|
+
var outputSchema97 = z97.discriminatedUnion("success", [
|
|
27684
|
+
z97.object({
|
|
27685
|
+
success: z97.literal(true),
|
|
27686
|
+
status: z97.number(),
|
|
27687
|
+
data: z97.unknown()
|
|
27688
|
+
}),
|
|
27689
|
+
z97.object({
|
|
27690
|
+
success: z97.literal(false),
|
|
27691
|
+
error: z97.string()
|
|
27692
|
+
})
|
|
27693
|
+
]);
|
|
27694
|
+
var requestTool56 = new ConnectorTool({
|
|
27695
|
+
name: "request",
|
|
27696
|
+
description: `Send authenticated requests to the Power BI REST API v1.0 using the user's Microsoft Entra OAuth token (proxied automatically).
|
|
27697
|
+
All paths are relative to https://api.powerbi.com/v1.0/myorg. Use the executeQueries endpoint to run DAX against a dataset.
|
|
27698
|
+
The signed-in user must have access to the workspace; unlike Service Principals, OAuth users can also access "My workspace" via the \`/datasets\` (without \`/groups/\`) endpoints.`,
|
|
27699
|
+
inputSchema: inputSchema97,
|
|
27700
|
+
outputSchema: outputSchema97,
|
|
27701
|
+
async execute({ connectionId, method, path: path5, queryParams, body }, connections, config) {
|
|
27702
|
+
const connection = connections.find((c) => c.id === connectionId);
|
|
27703
|
+
if (!connection) {
|
|
27704
|
+
return {
|
|
27705
|
+
success: false,
|
|
27706
|
+
error: `Connection ${connectionId} not found`
|
|
27707
|
+
};
|
|
27708
|
+
}
|
|
27709
|
+
console.log(
|
|
27710
|
+
`[connector-request] powerbi-oauth/${connection.name}: ${method} ${path5}`
|
|
27711
|
+
);
|
|
27712
|
+
try {
|
|
27713
|
+
const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT15);
|
|
27714
|
+
let url = `${BASE_URL41}${normalizedPath}`;
|
|
27715
|
+
if (queryParams) {
|
|
27716
|
+
const searchParams = new URLSearchParams(queryParams);
|
|
27717
|
+
url += `?${searchParams.toString()}`;
|
|
27718
|
+
}
|
|
27719
|
+
const token = await getProxyToken32(config.oauthProxy);
|
|
27720
|
+
const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
|
|
27721
|
+
const controller = new AbortController();
|
|
27722
|
+
const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS74);
|
|
27723
|
+
try {
|
|
27724
|
+
const response = await fetch(proxyUrl, {
|
|
27725
|
+
method: "POST",
|
|
27726
|
+
headers: {
|
|
27727
|
+
"Content-Type": "application/json",
|
|
27728
|
+
Authorization: `Bearer ${token}`
|
|
27729
|
+
},
|
|
27730
|
+
body: JSON.stringify({
|
|
27731
|
+
url,
|
|
27732
|
+
method,
|
|
27733
|
+
...body !== void 0 ? { body } : {}
|
|
27734
|
+
}),
|
|
27735
|
+
signal: controller.signal
|
|
27736
|
+
});
|
|
27737
|
+
const text = await response.text();
|
|
27738
|
+
const data = text ? (() => {
|
|
27739
|
+
try {
|
|
27740
|
+
return JSON.parse(text);
|
|
27741
|
+
} catch {
|
|
27742
|
+
return text;
|
|
27743
|
+
}
|
|
27744
|
+
})() : null;
|
|
27745
|
+
if (!response.ok) {
|
|
27746
|
+
const errorMessage = data && typeof data === "object" && "error" in data ? JSON.stringify(data.error) : typeof data === "string" && data ? data : `HTTP ${response.status} ${response.statusText}`;
|
|
27747
|
+
return { success: false, error: errorMessage };
|
|
27748
|
+
}
|
|
27749
|
+
return { success: true, status: response.status, data };
|
|
27750
|
+
} finally {
|
|
27751
|
+
clearTimeout(timeout);
|
|
27752
|
+
}
|
|
27753
|
+
} catch (err) {
|
|
27754
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
27755
|
+
return { success: false, error: msg };
|
|
27756
|
+
}
|
|
27757
|
+
}
|
|
27758
|
+
});
|
|
27759
|
+
|
|
27760
|
+
// ../connectors/src/connectors/powerbi-oauth/setup.ts
|
|
27761
|
+
var requestToolName13 = `powerbi-oauth_${requestTool56.name}`;
|
|
27762
|
+
var powerbiOauthOnboarding = new ConnectorOnboarding({
|
|
27763
|
+
connectionSetupInstructions: {
|
|
27764
|
+
ja: `Power BI OAuth \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
|
|
27765
|
+
|
|
27766
|
+
1. \`${requestToolName13}\` \u3092 \`method: "GET"\`\u3001\`path: "/groups"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
|
|
27767
|
+
2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u3001OAuth \u8A8D\u8A3C\u304C\u6B63\u3057\u304F\u5B8C\u4E86\u3057\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u30E6\u30FC\u30B6\u30FC\u306B\u4F1D\u3048\u308B
|
|
27768
|
+
|
|
27769
|
+
#### \u5236\u7D04
|
|
27770
|
+
- **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B DAX \u30AF\u30A8\u30EA\u306E\u5B9F\u884C\u3084\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306E\u66F4\u65B0\u3092\u884C\u308F\u306A\u3044\u3053\u3068**\u3002\u4E0A\u8A18\u306E\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u53D6\u5F97\u306E\u307F\u8A31\u53EF
|
|
27771
|
+
- \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057`,
|
|
27772
|
+
en: `Follow these steps to set up the Power BI OAuth connection.
|
|
27773
|
+
|
|
27774
|
+
1. Call \`${requestToolName13}\` with \`method: "GET"\` and \`path: "/groups"\` to list the workspaces the user has access to
|
|
27775
|
+
2. If an error is returned, ask the user to verify that OAuth authentication completed correctly
|
|
27776
|
+
|
|
27777
|
+
#### Constraints
|
|
27778
|
+
- **Do NOT execute DAX queries or refresh datasets during setup**. Only the workspace listing above is allowed
|
|
27779
|
+
- Write only 1 sentence between tool calls, then immediately call the next tool`
|
|
27780
|
+
},
|
|
27781
|
+
dataOverviewInstructions: {
|
|
27782
|
+
en: `1. Call powerbi-oauth_request with GET /groups to list accessible workspaces
|
|
27783
|
+
2. For a target workspace, call powerbi-oauth_request with GET /groups/{groupId}/datasets to list datasets
|
|
27784
|
+
3. Call powerbi-oauth_request with GET /groups/{groupId}/reports to list reports
|
|
27785
|
+
4. For each interesting dataset call powerbi-oauth_request with GET /groups/{groupId}/datasets/{datasetId}/tables to inspect tables`,
|
|
27786
|
+
ja: `1. powerbi-oauth_request \u3067 GET /groups \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27787
|
+
2. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306B\u5BFE\u3057\u3066 powerbi-oauth_request \u3067 GET /groups/{groupId}/datasets \u3092\u547C\u3073\u51FA\u3057\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27788
|
+
3. powerbi-oauth_request \u3067 GET /groups/{groupId}/reports \u3092\u547C\u3073\u51FA\u3057\u3001\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27789
|
+
4. \u8208\u5473\u306E\u3042\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u3064\u3044\u3066 powerbi-oauth_request \u3067 GET /groups/{groupId}/datasets/{datasetId}/tables \u3092\u547C\u3073\u51FA\u3057\u3001\u30C6\u30FC\u30D6\u30EB\u69CB\u9020\u3092\u78BA\u8A8D`
|
|
27790
|
+
}
|
|
27791
|
+
});
|
|
27792
|
+
|
|
27793
|
+
// ../connectors/src/connectors/powerbi-oauth/parameters.ts
|
|
27794
|
+
var parameters80 = {};
|
|
27795
|
+
|
|
27796
|
+
// ../connectors/src/connectors/powerbi-oauth/index.ts
|
|
27797
|
+
var tools80 = { request: requestTool56 };
|
|
27798
|
+
var powerbiOauthConnector = new ConnectorPlugin({
|
|
27799
|
+
slug: "powerbi",
|
|
27800
|
+
authType: AUTH_TYPES.OAUTH,
|
|
27801
|
+
name: "Power BI",
|
|
27802
|
+
description: "Connect to Microsoft Power BI using OAuth (Microsoft Entra ID). Use it to enumerate workspaces, datasets, and reports the signed-in user has access to, and to run DAX queries.",
|
|
27803
|
+
iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2vXQCKGpMJ9kGSaqkZl9IS/cc5669c267fc5d11e7b1f8c01723e461/power-bi-icon.png",
|
|
27804
|
+
parameters: parameters80,
|
|
27805
|
+
releaseFlag: { dev1: true, dev2: false, prod: false },
|
|
27806
|
+
categories: ["bi"],
|
|
27807
|
+
onboarding: powerbiOauthOnboarding,
|
|
27808
|
+
proxyPolicy: {
|
|
27809
|
+
allowlist: [
|
|
27810
|
+
{
|
|
27811
|
+
host: "api.powerbi.com",
|
|
27812
|
+
methods: ["GET", "POST", "PATCH", "PUT", "DELETE"]
|
|
27813
|
+
}
|
|
27814
|
+
]
|
|
27815
|
+
},
|
|
27816
|
+
systemPrompt: {
|
|
27817
|
+
en: `### Tools
|
|
27818
|
+
|
|
27819
|
+
- \`powerbi-oauth_request\`: The only way to call the Power BI REST API v1.0. Use it to list workspaces (\`/groups\`), datasets, reports, and to run DAX via the \`executeQueries\` endpoint. Authentication is configured automatically via OAuth (Microsoft Entra ID).
|
|
27820
|
+
|
|
27821
|
+
### Business Logic
|
|
27822
|
+
|
|
27823
|
+
The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT access credentials directly from environment variables and do NOT read \`INTERNAL_SQUADBASE_*\` env vars \u2014 the SDK takes care of OAuth.
|
|
27824
|
+
|
|
27825
|
+
SDK surface (client created via \`connection(connectionId)\`):
|
|
27826
|
+
- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path appended to \`https://api.powerbi.com/v1.0/myorg\`)
|
|
27827
|
+
- \`client.listGroups(options?)\` \u2014 list workspaces (\`$top\`, \`$skip\`, \`$filter\`)
|
|
27828
|
+
- \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 list datasets / reports in a workspace
|
|
27829
|
+
- \`client.getDataset(groupId, datasetId)\` \u2014 fetch a single dataset
|
|
27830
|
+
- \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 run DAX queries
|
|
27831
|
+
- \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 trigger an async refresh
|
|
27832
|
+
|
|
27833
|
+
If a handler test fails with \`Connection proxy is not configured\`, retry \u2014 the sandbox is still initializing. Do NOT abandon the SDK and construct OAuth proxy URLs manually.
|
|
27834
|
+
|
|
27835
|
+
\`\`\`ts
|
|
27836
|
+
import type { Context } from "hono";
|
|
27837
|
+
import { connection } from "@squadbase/vite-server/connectors/powerbi-oauth";
|
|
27838
|
+
|
|
27839
|
+
const powerbi = connection("<connectionId>");
|
|
27840
|
+
|
|
27841
|
+
export default async function handler(c: Context) {
|
|
27842
|
+
const { groupId, datasetId, dax } = await c.req.json<{
|
|
27843
|
+
groupId: string;
|
|
27844
|
+
datasetId: string;
|
|
27845
|
+
dax: string;
|
|
27846
|
+
}>();
|
|
27847
|
+
|
|
27848
|
+
const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
|
|
27849
|
+
const rows = result.results[0]?.tables[0]?.rows ?? [];
|
|
27850
|
+
return c.json({ rows });
|
|
27851
|
+
}
|
|
27852
|
+
\`\`\`
|
|
27853
|
+
|
|
27854
|
+
### Power BI REST API Reference
|
|
27855
|
+
|
|
27856
|
+
- Base URL: \`https://api.powerbi.com/v1.0/myorg\`
|
|
27857
|
+
- Authentication: Microsoft Entra OAuth (delegated; handled automatically)
|
|
27858
|
+
- Unlike Service Principals, OAuth users can also access "My workspace" via the \`/datasets\` (without \`/groups/\`) endpoints
|
|
27859
|
+
|
|
27860
|
+
#### Common Endpoints
|
|
27861
|
+
- GET \`/groups\` \u2014 List workspaces the signed-in user has access to
|
|
27862
|
+
- GET \`/groups/{groupId}/datasets\` \u2014 List datasets in a workspace
|
|
27863
|
+
- GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 Get dataset metadata
|
|
27864
|
+
- GET \`/groups/{groupId}/reports\` \u2014 List reports
|
|
27865
|
+
- POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 Run DAX (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
|
|
27866
|
+
- POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 Trigger a dataset refresh
|
|
27867
|
+
- GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 List recent refresh history
|
|
27868
|
+
|
|
27869
|
+
#### DAX Tips
|
|
27870
|
+
- \`EVALUATE TOPN(10, 'TableName')\` \u2014 sample 10 rows from a table
|
|
27871
|
+
- \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 aggregate
|
|
27872
|
+
- Each \`executeQueries\` call accepts one query in the \`queries\` array (per current Power BI API limits)`,
|
|
27873
|
+
ja: `### \u30C4\u30FC\u30EB
|
|
27874
|
+
|
|
27875
|
+
- \`powerbi-oauth_request\`: Power BI REST API v1.0 \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9 (\`/groups\`)\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3001\u30EC\u30DD\u30FC\u30C8\u306E\u4E00\u89A7\u53D6\u5F97\u3084\u3001\`executeQueries\` \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u308B DAX \u306E\u5B9F\u884C\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth (Microsoft Entra ID) \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
|
|
27876
|
+
|
|
27877
|
+
### Business Logic
|
|
27878
|
+
|
|
27879
|
+
\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\`INTERNAL_SQUADBASE_*\` \u306E\u74B0\u5883\u5909\u6570\u3092\u4F7F\u3063\u3066\u624B\u52D5\u3067 OAuth \u30D7\u30ED\u30AD\u30B7\u3092\u53E9\u304F\u3053\u3068\u3082\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044 \u2014 SDK \u304C OAuth \u3092\u51E6\u7406\u3057\u307E\u3059\u3002
|
|
27880
|
+
|
|
27881
|
+
SDK (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
|
|
27882
|
+
- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`https://api.powerbi.com/v1.0/myorg\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059)
|
|
27883
|
+
- \`client.listGroups(options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7 (\`$top\`, \`$skip\`, \`$filter\`)
|
|
27884
|
+
- \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8/\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
|
|
27885
|
+
- \`client.getDataset(groupId, datasetId)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u5358\u4F53\u53D6\u5F97
|
|
27886
|
+
- \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 DAX \u30AF\u30A8\u30EA\u5B9F\u884C
|
|
27887
|
+
- \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u3092\u975E\u540C\u671F\u30C8\u30EA\u30AC\u30FC
|
|
27888
|
+
|
|
27889
|
+
\u30CF\u30F3\u30C9\u30E9\u306E\u30C6\u30B9\u30C8\u304C \`Connection proxy is not configured\` \u3067\u5931\u6557\u3059\u308B\u5834\u5408\u306F\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002SDK \u3092\u8AE6\u3081\u3066 OAuth \u30D7\u30ED\u30AD\u30B7\u306E URL \u3092\u81EA\u5206\u3067\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u306F **\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044**\u3002
|
|
27890
|
+
|
|
27891
|
+
\`\`\`ts
|
|
27892
|
+
import type { Context } from "hono";
|
|
27893
|
+
import { connection } from "@squadbase/vite-server/connectors/powerbi-oauth";
|
|
27894
|
+
|
|
27895
|
+
const powerbi = connection("<connectionId>");
|
|
27896
|
+
|
|
27897
|
+
export default async function handler(c: Context) {
|
|
27898
|
+
const { groupId, datasetId, dax } = await c.req.json<{
|
|
27899
|
+
groupId: string;
|
|
27900
|
+
datasetId: string;
|
|
27901
|
+
dax: string;
|
|
27902
|
+
}>();
|
|
27903
|
+
|
|
27904
|
+
const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
|
|
27905
|
+
const rows = result.results[0]?.tables[0]?.rows ?? [];
|
|
27906
|
+
return c.json({ rows });
|
|
27907
|
+
}
|
|
27908
|
+
\`\`\`
|
|
27909
|
+
|
|
27910
|
+
### Power BI REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
|
|
27911
|
+
|
|
27912
|
+
- \u30D9\u30FC\u30B9 URL: \`https://api.powerbi.com/v1.0/myorg\`
|
|
27913
|
+
- \u8A8D\u8A3C: Microsoft Entra OAuth (\u59D4\u4EFB\u578B\u3001\u81EA\u52D5\u8A2D\u5B9A)
|
|
27914
|
+
- Service Principal \u3068\u7570\u306A\u308A\u3001OAuth \u30E6\u30FC\u30B6\u30FC\u306F \`/datasets\` (\`/groups/\` \u7121\u3057) \u3067\u300C\u30DE\u30A4 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u300D\u306B\u3082\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD
|
|
27915
|
+
|
|
27916
|
+
#### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
|
|
27917
|
+
- GET \`/groups\` \u2014 \u30E6\u30FC\u30B6\u30FC\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7
|
|
27918
|
+
- GET \`/groups/{groupId}/datasets\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7
|
|
27919
|
+
- GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 \u30E1\u30BF\u30C7\u30FC\u30BF
|
|
27920
|
+
- GET \`/groups/{groupId}/reports\` \u2014 \u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
|
|
27921
|
+
- POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 DAX \u5B9F\u884C (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
|
|
27922
|
+
- POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u30C8\u30EA\u30AC\u30FC
|
|
27923
|
+
- GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u76F4\u8FD1\u306E\u66F4\u65B0\u5C65\u6B74
|
|
27924
|
+
|
|
27925
|
+
#### DAX Tips
|
|
27926
|
+
- \`EVALUATE TOPN(10, 'TableName')\` \u2014 \u30C6\u30FC\u30D6\u30EB\u304B\u3089 10 \u884C\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
|
|
27927
|
+
- \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 \u96C6\u8A08
|
|
27928
|
+
- \`executeQueries\` \u306F\u73FE\u72B6 1 \u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u3064\u304D 1 \u30AF\u30A8\u30EA\u306E\u307F`
|
|
27929
|
+
},
|
|
27930
|
+
tools: tools80,
|
|
27931
|
+
async checkConnection(_params, config) {
|
|
27932
|
+
const { proxyFetch } = config;
|
|
27933
|
+
const url = "https://api.powerbi.com/v1.0/myorg/groups?$top=1";
|
|
27934
|
+
try {
|
|
27935
|
+
const res = await proxyFetch(url, { method: "GET" });
|
|
27936
|
+
if (!res.ok) {
|
|
27937
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
27938
|
+
return {
|
|
27939
|
+
success: false,
|
|
27940
|
+
error: `Power BI API failed: HTTP ${res.status} ${errorText}`
|
|
27941
|
+
};
|
|
27942
|
+
}
|
|
27943
|
+
return { success: true };
|
|
27944
|
+
} catch (error) {
|
|
27945
|
+
return {
|
|
27946
|
+
success: false,
|
|
27947
|
+
error: error instanceof Error ? error.message : String(error)
|
|
27948
|
+
};
|
|
27949
|
+
}
|
|
27950
|
+
}
|
|
27951
|
+
});
|
|
27952
|
+
|
|
27953
|
+
// ../connectors/src/connectors/tableau/setup.ts
|
|
27954
|
+
var tableauOnboarding = new ConnectorOnboarding({
|
|
27955
|
+
connectionSetupInstructions: {
|
|
27956
|
+
en: `Follow these steps to verify the Tableau PAT connection.
|
|
27957
|
+
|
|
27958
|
+
1. Call \`tableau_request\` with \`method: "GET"\` and \`path: "/sites/{siteId}/projects?pageSize=5"\` to list a few projects on the signed-in site
|
|
27959
|
+
2. If the call fails with HTTP 401, ask the user to confirm the PAT name/secret and that the Site Content URL matches the site where the PAT was issued (Tableau Cloud sites are case-sensitive)
|
|
27960
|
+
|
|
27961
|
+
#### Constraints
|
|
27962
|
+
- **Do NOT mutate Tableau resources during setup** (no publish/update/delete). Only the project listing above is allowed
|
|
27963
|
+
- The literal placeholder \`{siteId}\` in the path is automatically replaced with the session's site ID \u2014 do NOT hardcode the ID`,
|
|
27964
|
+
ja: `Tableau PAT \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
|
|
27965
|
+
|
|
27966
|
+
1. \`tableau_request\` \u3092 \`method: "GET"\`\u3001\`path: "/sites/{siteId}/projects?pageSize=5"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30B5\u30A4\u30F3\u30A4\u30F3\u5148\u30B5\u30A4\u30C8\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u3044\u304F\u3064\u304B\u53D6\u5F97\u3059\u308B
|
|
27967
|
+
2. HTTP 401 \u3067\u5931\u6557\u3057\u305F\u5834\u5408\u306F\u3001PAT \u540D/\u30B7\u30FC\u30AF\u30EC\u30C3\u30C8\u304A\u3088\u3073 Site Content URL \u304C PAT \u767A\u884C\u30B5\u30A4\u30C8\u3068\u4E00\u81F4\u3057\u3066\u3044\u308B\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B\uFF08Tableau Cloud \u306E\u30B5\u30A4\u30C8\u540D\u306F\u5927\u6587\u5B57\u5C0F\u6587\u5B57\u3092\u533A\u5225\uFF09
|
|
27968
|
+
|
|
27969
|
+
#### \u5236\u7D04
|
|
27970
|
+
- **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B Tableau \u30EA\u30BD\u30FC\u30B9\u3092\u5909\u66F4\u3057\u306A\u3044\u3053\u3068**\uFF08publish/update/delete \u4E0D\u53EF\uFF09\u3002\u4E0A\u8A18\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u53D6\u5F97\u306E\u307F\u8A31\u53EF
|
|
27971
|
+
- \u30D1\u30B9\u5185\u306E\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC \`{siteId}\` \u306F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059 \u2014 ID \u3092\u30CF\u30FC\u30C9\u30B3\u30FC\u30C9\u3057\u306A\u3044\u3053\u3068`
|
|
27972
|
+
},
|
|
27973
|
+
dataOverviewInstructions: {
|
|
27974
|
+
en: `1. Call tableau_request with GET /sites/{siteId}/projects to list projects
|
|
27975
|
+
2. Call tableau_request with GET /sites/{siteId}/workbooks?pageSize=20 to list workbooks
|
|
27976
|
+
3. For a target workbook, call tableau_request with GET /sites/{siteId}/workbooks/{workbookId}/views to list its views
|
|
27977
|
+
4. Call tableau_request with GET /sites/{siteId}/datasources?pageSize=20 to list published data sources`,
|
|
27978
|
+
ja: `1. tableau_request \u3067 GET /sites/{siteId}/projects \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27979
|
+
2. tableau_request \u3067 GET /sites/{siteId}/workbooks?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27980
|
+
3. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u306B\u3064\u3044\u3066 tableau_request \u3067 GET /sites/{siteId}/workbooks/{workbookId}/views \u3092\u547C\u3073\u51FA\u3057\u3001\u30D3\u30E5\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
|
|
27981
|
+
4. tableau_request \u3067 GET /sites/{siteId}/datasources?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97`
|
|
27982
|
+
}
|
|
27983
|
+
});
|
|
27984
|
+
|
|
27985
|
+
// ../connectors/src/connectors/tableau/parameters.ts
|
|
27986
|
+
var parameters81 = {
|
|
27987
|
+
serverUrl: new ParameterDefinition({
|
|
27988
|
+
slug: "server-url",
|
|
27989
|
+
name: "Tableau Server URL",
|
|
27990
|
+
description: "Base URL of your Tableau Cloud / Server instance (no trailing slash). Examples: https://us-east-1.online.tableau.com, https://prod-useast-a.online.tableau.com, https://tableau.example.com.",
|
|
27991
|
+
envVarBaseKey: "TABLEAU_SERVER_URL",
|
|
27992
|
+
type: "text",
|
|
27993
|
+
secret: false,
|
|
27994
|
+
required: true
|
|
27995
|
+
}),
|
|
27996
|
+
siteContentUrl: new ParameterDefinition({
|
|
27997
|
+
slug: "site-content-url",
|
|
27998
|
+
name: "Site Content URL",
|
|
27999
|
+
description: "The site's content URL (the value after '/site/' in the Tableau URL). On Tableau Cloud this is required (e.g. 'mycompany'). On Tableau Server the Default site uses an empty string \u2014 pass an empty string explicitly.",
|
|
28000
|
+
envVarBaseKey: "TABLEAU_SITE_CONTENT_URL",
|
|
28001
|
+
type: "text",
|
|
28002
|
+
secret: false,
|
|
28003
|
+
required: true
|
|
28004
|
+
}),
|
|
28005
|
+
patName: new ParameterDefinition({
|
|
28006
|
+
slug: "pat-name",
|
|
28007
|
+
name: "Personal Access Token Name",
|
|
28008
|
+
description: "Name of the Personal Access Token (PAT) generated under Account Settings > Personal Access Tokens. The owning user's site role determines the API permissions.",
|
|
28009
|
+
envVarBaseKey: "TABLEAU_PAT_NAME",
|
|
28010
|
+
type: "text",
|
|
28011
|
+
secret: false,
|
|
28012
|
+
required: true
|
|
28013
|
+
}),
|
|
28014
|
+
patSecret: new ParameterDefinition({
|
|
28015
|
+
slug: "pat-secret",
|
|
28016
|
+
name: "Personal Access Token Secret",
|
|
28017
|
+
description: "Secret value shown once when the PAT is created. Tokens expire after 15 days of inactivity (default) and must be rotated regularly.",
|
|
28018
|
+
envVarBaseKey: "TABLEAU_PAT_SECRET",
|
|
28019
|
+
type: "text",
|
|
28020
|
+
secret: true,
|
|
28021
|
+
required: true
|
|
28022
|
+
}),
|
|
28023
|
+
apiVersion: new ParameterDefinition({
|
|
28024
|
+
slug: "api-version",
|
|
28025
|
+
name: "REST API Version",
|
|
28026
|
+
description: "Optional Tableau REST API version (e.g., '3.28'). Defaults to '3.28' which works with current Tableau Cloud and recent Tableau Server releases. Use the version listed at https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm if you need to pin.",
|
|
28027
|
+
envVarBaseKey: "TABLEAU_API_VERSION",
|
|
28028
|
+
type: "text",
|
|
28029
|
+
secret: false,
|
|
28030
|
+
required: false
|
|
28031
|
+
})
|
|
28032
|
+
};
|
|
28033
|
+
|
|
28034
|
+
// ../connectors/src/connectors/tableau/tools/request.ts
|
|
28035
|
+
import { z as z98 } from "zod";
|
|
28036
|
+
var DEFAULT_API_VERSION = "3.28";
|
|
28037
|
+
var REQUEST_TIMEOUT_MS75 = 6e4;
|
|
28038
|
+
var sessionCache = /* @__PURE__ */ new Map();
|
|
28039
|
+
function buildBaseUrl4(serverUrl, apiVersion) {
|
|
28040
|
+
return `${serverUrl.replace(/\/$/, "")}/api/${apiVersion}`;
|
|
28041
|
+
}
|
|
28042
|
+
async function signIn(serverUrl, apiVersion, siteContentUrl, patName, patSecret) {
|
|
28043
|
+
const url = `${buildBaseUrl4(serverUrl, apiVersion)}/auth/signin`;
|
|
28044
|
+
const body = {
|
|
28045
|
+
credentials: {
|
|
28046
|
+
personalAccessTokenName: patName,
|
|
28047
|
+
personalAccessTokenSecret: patSecret,
|
|
28048
|
+
site: { contentUrl: siteContentUrl }
|
|
28049
|
+
}
|
|
28050
|
+
};
|
|
28051
|
+
const res = await fetch(url, {
|
|
28052
|
+
method: "POST",
|
|
28053
|
+
headers: {
|
|
28054
|
+
"Content-Type": "application/json",
|
|
28055
|
+
Accept: "application/json"
|
|
28056
|
+
},
|
|
28057
|
+
body: JSON.stringify(body)
|
|
28058
|
+
});
|
|
28059
|
+
if (!res.ok) {
|
|
28060
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
28061
|
+
throw new Error(
|
|
28062
|
+
`Tableau sign-in failed: HTTP ${res.status} ${errorText}`
|
|
28063
|
+
);
|
|
28064
|
+
}
|
|
28065
|
+
const data = await res.json();
|
|
28066
|
+
return {
|
|
28067
|
+
authToken: data.credentials.token,
|
|
28068
|
+
siteId: data.credentials.site.id,
|
|
28069
|
+
userId: data.credentials.user.id,
|
|
28070
|
+
expiresAt: Date.now() + 30 * 60 * 1e3
|
|
28071
|
+
};
|
|
28072
|
+
}
|
|
28073
|
+
async function getSession(serverUrl, apiVersion, siteContentUrl, patName, patSecret) {
|
|
28074
|
+
const cacheKey = `${serverUrl}|${siteContentUrl}|${patName}`;
|
|
28075
|
+
const cached = sessionCache.get(cacheKey);
|
|
28076
|
+
if (cached && cached.expiresAt > Date.now() + 6e4) {
|
|
28077
|
+
return cached;
|
|
28078
|
+
}
|
|
28079
|
+
const session = await signIn(
|
|
28080
|
+
serverUrl,
|
|
28081
|
+
apiVersion,
|
|
28082
|
+
siteContentUrl,
|
|
28083
|
+
patName,
|
|
28084
|
+
patSecret
|
|
28085
|
+
);
|
|
28086
|
+
sessionCache.set(cacheKey, session);
|
|
28087
|
+
return session;
|
|
28088
|
+
}
|
|
28089
|
+
var inputSchema98 = z98.object({
|
|
28090
|
+
toolUseIntent: z98.string().optional().describe(
|
|
28091
|
+
"Brief description of what you intend to accomplish with this tool call"
|
|
28092
|
+
),
|
|
28093
|
+
connectionId: z98.string().describe("ID of the Tableau connection to use"),
|
|
28094
|
+
method: z98.enum(["GET", "POST", "PUT", "DELETE"]).describe(
|
|
28095
|
+
"HTTP method. GET for listing/reading, POST for creating, PUT for updates, DELETE for removal."
|
|
28096
|
+
),
|
|
28097
|
+
path: z98.string().describe(
|
|
28098
|
+
"API path appended to {serverUrl}/api/{apiVersion} (e.g., '/sites/{siteId}/projects', '/sites/{siteId}/workbooks/{workbookId}', '/sites/{siteId}/views/{viewId}/data'). The {siteId} placeholder is automatically replaced with the signed-in site ID."
|
|
28099
|
+
),
|
|
28100
|
+
queryParams: z98.record(z98.string(), z98.string()).optional().describe(
|
|
28101
|
+
"Query parameters to append (e.g., { pageSize: '100', filter: 'name:eq:Sales' }). Tableau supports field filtering via 'fields' and sorting via 'sort'."
|
|
28102
|
+
),
|
|
28103
|
+
body: z98.record(z98.string(), z98.unknown()).optional().describe(
|
|
28104
|
+
"JSON request body for POST/PUT (Tableau also accepts XML, but JSON is recommended with Accept: application/json)."
|
|
28105
|
+
)
|
|
28106
|
+
});
|
|
28107
|
+
var outputSchema98 = z98.discriminatedUnion("success", [
|
|
28108
|
+
z98.object({
|
|
28109
|
+
success: z98.literal(true),
|
|
28110
|
+
status: z98.number(),
|
|
28111
|
+
data: z98.unknown()
|
|
28112
|
+
}),
|
|
28113
|
+
z98.object({
|
|
28114
|
+
success: z98.literal(false),
|
|
28115
|
+
error: z98.string()
|
|
28116
|
+
})
|
|
28117
|
+
]);
|
|
28118
|
+
var requestTool57 = new ConnectorTool({
|
|
28119
|
+
name: "request",
|
|
28120
|
+
description: `Send authenticated requests to the Tableau REST API.
|
|
28121
|
+
The tool signs in once with the configured Personal Access Token (PAT) to obtain an X-Tableau-Auth token (cached per connection), then forwards the request with the token attached.
|
|
28122
|
+
All paths are relative to {serverUrl}/api/{apiVersion}. Use the literal placeholder \`{siteId}\` in the path \u2014 it is automatically substituted with the site ID returned from sign-in.
|
|
28123
|
+
Accept and Content-Type headers default to application/json so list responses come back as JSON instead of Tableau's default XML.`,
|
|
28124
|
+
inputSchema: inputSchema98,
|
|
28125
|
+
outputSchema: outputSchema98,
|
|
28126
|
+
async execute({ connectionId, method, path: path5, queryParams, body }, connections) {
|
|
28127
|
+
const connection = connections.find((c) => c.id === connectionId);
|
|
28128
|
+
if (!connection) {
|
|
28129
|
+
return {
|
|
28130
|
+
success: false,
|
|
28131
|
+
error: `Connection ${connectionId} not found`
|
|
28132
|
+
};
|
|
28133
|
+
}
|
|
28134
|
+
console.log(
|
|
28135
|
+
`[connector-request] tableau/${connection.name}: ${method} ${path5}`
|
|
28136
|
+
);
|
|
28137
|
+
try {
|
|
28138
|
+
const serverUrl = parameters81.serverUrl.getValue(connection);
|
|
28139
|
+
const siteContentUrl = parameters81.siteContentUrl.getValue(connection);
|
|
28140
|
+
const patName = parameters81.patName.getValue(connection);
|
|
28141
|
+
const patSecret = parameters81.patSecret.getValue(connection);
|
|
28142
|
+
const apiVersion = parameters81.apiVersion.tryGetValue(connection) || DEFAULT_API_VERSION;
|
|
28143
|
+
const session = await getSession(
|
|
28144
|
+
serverUrl,
|
|
28145
|
+
apiVersion,
|
|
28146
|
+
siteContentUrl,
|
|
28147
|
+
patName,
|
|
28148
|
+
patSecret
|
|
28149
|
+
);
|
|
28150
|
+
const resolvedPath = path5.trim().replace(/\{siteId\}/g, session.siteId).replace(/^([^/])/, "/$1");
|
|
28151
|
+
let url = `${buildBaseUrl4(serverUrl, apiVersion)}${resolvedPath}`;
|
|
28152
|
+
if (queryParams) {
|
|
28153
|
+
const searchParams = new URLSearchParams(queryParams);
|
|
28154
|
+
url += `?${searchParams.toString()}`;
|
|
28155
|
+
}
|
|
28156
|
+
const controller = new AbortController();
|
|
28157
|
+
const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS75);
|
|
28158
|
+
try {
|
|
28159
|
+
const init = {
|
|
28160
|
+
method,
|
|
28161
|
+
headers: {
|
|
28162
|
+
"X-Tableau-Auth": session.authToken,
|
|
28163
|
+
Accept: "application/json",
|
|
28164
|
+
"Content-Type": "application/json"
|
|
28165
|
+
},
|
|
28166
|
+
signal: controller.signal
|
|
28167
|
+
};
|
|
28168
|
+
if (body !== void 0) {
|
|
28169
|
+
init.body = JSON.stringify(body);
|
|
28170
|
+
}
|
|
28171
|
+
const response = await fetch(url, init);
|
|
28172
|
+
const text = await response.text();
|
|
28173
|
+
const data = text ? (() => {
|
|
28174
|
+
try {
|
|
28175
|
+
return JSON.parse(text);
|
|
28176
|
+
} catch {
|
|
28177
|
+
return text;
|
|
28178
|
+
}
|
|
28179
|
+
})() : null;
|
|
28180
|
+
if (!response.ok) {
|
|
28181
|
+
const errorMessage = data && typeof data === "object" && "error" in data ? JSON.stringify(data.error) : typeof data === "string" && data ? data : `HTTP ${response.status} ${response.statusText}`;
|
|
28182
|
+
return { success: false, error: errorMessage };
|
|
28183
|
+
}
|
|
28184
|
+
return { success: true, status: response.status, data };
|
|
28185
|
+
} finally {
|
|
28186
|
+
clearTimeout(timeout);
|
|
28187
|
+
}
|
|
28188
|
+
} catch (err) {
|
|
28189
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
28190
|
+
return { success: false, error: msg };
|
|
28191
|
+
}
|
|
28192
|
+
}
|
|
28193
|
+
});
|
|
28194
|
+
|
|
28195
|
+
// ../connectors/src/connectors/tableau/index.ts
|
|
28196
|
+
var tools81 = { request: requestTool57 };
|
|
28197
|
+
var tableauConnector = new ConnectorPlugin({
|
|
28198
|
+
slug: "tableau",
|
|
28199
|
+
authType: AUTH_TYPES.PAT,
|
|
28200
|
+
name: "Tableau",
|
|
28201
|
+
description: "Connect to Tableau Cloud or Tableau Server via a Personal Access Token (PAT). Use it to enumerate projects, workbooks, views, and data sources, and to pull view data.",
|
|
28202
|
+
iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/3ejrZvfw7zCDa3FPbUNQx9/d810e117b3a86c45dd96205453bf67a0/tableau-icon.svg",
|
|
28203
|
+
parameters: parameters81,
|
|
28204
|
+
releaseFlag: { dev1: true, dev2: false, prod: false },
|
|
28205
|
+
categories: ["bi"],
|
|
28206
|
+
onboarding: tableauOnboarding,
|
|
28207
|
+
systemPrompt: {
|
|
28208
|
+
en: `### Tools
|
|
28209
|
+
|
|
28210
|
+
- \`tableau_request\`: The only way to call the Tableau REST API. Use it for projects, workbooks, views, data sources, users, and permissions. The tool signs in once with the configured PAT to obtain an \`X-Tableau-Auth\` token (cached), then forwards each request with the token attached. Use the literal \`{siteId}\` placeholder in the path \u2014 it is replaced with the session's site ID automatically.
|
|
28211
|
+
|
|
28212
|
+
### Business Logic
|
|
28213
|
+
|
|
28214
|
+
The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
|
|
28215
|
+
|
|
28216
|
+
SDK methods (client created via \`connection(connectionId)\`):
|
|
28217
|
+
- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path is appended to \`{serverUrl}/api/{apiVersion}\`; \`{siteId}\` is substituted)
|
|
28218
|
+
- \`client.getSession()\` \u2014 sign in (if needed) and return \`{ authToken, siteId, userId }\`
|
|
28219
|
+
- \`client.listProjects(options?)\` / \`client.listWorkbooks(options?)\` / \`client.listDatasources(options?)\`
|
|
28220
|
+
- \`client.listViewsForWorkbook(workbookId)\`
|
|
28221
|
+
- \`client.getViewData(viewId)\` \u2014 returns the view's underlying data as CSV text
|
|
28222
|
+
|
|
28223
|
+
\`\`\`ts
|
|
28224
|
+
import type { Context } from "hono";
|
|
28225
|
+
import { connection } from "@squadbase/vite-server/connectors/tableau";
|
|
28226
|
+
|
|
28227
|
+
const tableau = connection("<connectionId>");
|
|
28228
|
+
|
|
28229
|
+
export default async function handler(c: Context) {
|
|
28230
|
+
const { pageSize = 20 } = await c.req.json<{ pageSize?: number }>();
|
|
28231
|
+
const { workbooks, pagination } = await tableau.listWorkbooks({ pageSize });
|
|
28232
|
+
return c.json({
|
|
28233
|
+
workbooks: workbooks.workbook,
|
|
28234
|
+
totalAvailable: Number(pagination.totalAvailable),
|
|
28235
|
+
});
|
|
28236
|
+
}
|
|
28237
|
+
\`\`\`
|
|
28238
|
+
|
|
28239
|
+
### Tableau REST API Reference
|
|
28240
|
+
|
|
28241
|
+
- Base URL: \`{serverUrl}/api/{apiVersion}\` (default version 3.28; see https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)
|
|
28242
|
+
- Authentication: Sign-in with a PAT returns \`X-Tableau-Auth\` token, site ID, and user ID. Sessions expire after ~240 minutes idle on Tableau Cloud
|
|
28243
|
+
- Response format: JSON when \`Accept: application/json\` is sent (default); otherwise Tableau returns XML
|
|
28244
|
+
- Pagination: \`?pageSize=&pageNumber=\` query params with \`pagination\` object in response
|
|
28245
|
+
|
|
28246
|
+
#### Common Endpoints
|
|
28247
|
+
- POST \`/auth/signin\` \u2014 sign in (handled automatically)
|
|
28248
|
+
- POST \`/auth/signout\` \u2014 sign out
|
|
28249
|
+
- GET \`/sites/{siteId}/projects\` \u2014 list projects
|
|
28250
|
+
- GET \`/sites/{siteId}/workbooks\` \u2014 list workbooks (supports \`filter\`, \`sort\`)
|
|
28251
|
+
- GET \`/sites/{siteId}/workbooks/{workbookId}\` \u2014 get a workbook
|
|
28252
|
+
- GET \`/sites/{siteId}/workbooks/{workbookId}/views\` \u2014 list views in a workbook
|
|
28253
|
+
- GET \`/sites/{siteId}/views/{viewId}/data\` \u2014 get view data as CSV
|
|
28254
|
+
- GET \`/sites/{siteId}/views/{viewId}/image\` \u2014 get view as PNG
|
|
28255
|
+
- GET \`/sites/{siteId}/views/{viewId}/pdf\` \u2014 get view as PDF
|
|
28256
|
+
- GET \`/sites/{siteId}/datasources\` \u2014 list published data sources
|
|
28257
|
+
- GET \`/sites/{siteId}/users\` \u2014 list users
|
|
28258
|
+
- GET \`/sites/{siteId}/groups\` \u2014 list groups
|
|
28259
|
+
|
|
28260
|
+
#### Filter Syntax
|
|
28261
|
+
- \`filter=name:eq:Sales\` \u2014 exact match
|
|
28262
|
+
- \`filter=name:in:[Sales,Marketing]\` \u2014 set membership
|
|
28263
|
+
- \`filter=updatedAt:gte:2024-01-01T00:00:00Z\` \u2014 comparison operators (gt/gte/lt/lte)
|
|
28264
|
+
- Combine: \`filter=ownerName:eq:alice,tags:in:[finance]\``,
|
|
28265
|
+
ja: `### \u30C4\u30FC\u30EB
|
|
28266
|
+
|
|
28267
|
+
- \`tableau_request\`: Tableau REST API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u3001\u30D3\u30E5\u30FC\u3001\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u6A29\u9650\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A2D\u5B9A\u3055\u308C\u305F PAT \u3067\u4E00\u5EA6\u30B5\u30A4\u30F3\u30A4\u30F3\u3057\u3066 \`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97 (\u30AD\u30E3\u30C3\u30B7\u30E5) \u3057\u3001\u5404\u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u305D\u306E\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u3066\u9001\u4FE1\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306B\u306F \`{siteId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044 \u2014 \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
|
|
28268
|
+
|
|
28269
|
+
### Business Logic
|
|
28270
|
+
|
|
28271
|
+
\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
|
|
28272
|
+
|
|
28273
|
+
SDK \u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
|
|
28274
|
+
- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`{serverUrl}/api/{apiVersion}\` \u306B\u8FFD\u52A0\u3055\u308C\u3001\`{siteId}\` \u306F\u7F6E\u63DB\u3055\u308C\u307E\u3059)
|
|
28275
|
+
- \`client.getSession()\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3 (\u5FC5\u8981\u306A\u3089) \u3057\u3066 \`{ authToken, siteId, userId }\` \u3092\u8FD4\u3059
|
|
28276
|
+
- \`client.listProjects(options?)\` / \`client.listWorkbooks(options?)\` / \`client.listDatasources(options?)\`
|
|
28277
|
+
- \`client.listViewsForWorkbook(workbookId)\`
|
|
28278
|
+
- \`client.getViewData(viewId)\` \u2014 \u30D3\u30E5\u30FC\u306E\u30C7\u30FC\u30BF\u3092 CSV \u30C6\u30AD\u30B9\u30C8\u3067\u8FD4\u3059
|
|
28279
|
+
|
|
28280
|
+
\`\`\`ts
|
|
28281
|
+
import type { Context } from "hono";
|
|
28282
|
+
import { connection } from "@squadbase/vite-server/connectors/tableau";
|
|
28283
|
+
|
|
28284
|
+
const tableau = connection("<connectionId>");
|
|
28285
|
+
|
|
28286
|
+
export default async function handler(c: Context) {
|
|
28287
|
+
const { pageSize = 20 } = await c.req.json<{ pageSize?: number }>();
|
|
28288
|
+
const { workbooks, pagination } = await tableau.listWorkbooks({ pageSize });
|
|
28289
|
+
return c.json({
|
|
28290
|
+
workbooks: workbooks.workbook,
|
|
28291
|
+
totalAvailable: Number(pagination.totalAvailable),
|
|
28292
|
+
});
|
|
28293
|
+
}
|
|
28294
|
+
\`\`\`
|
|
28295
|
+
|
|
28296
|
+
### Tableau REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
|
|
28297
|
+
|
|
28298
|
+
- \u30D9\u30FC\u30B9 URL: \`{serverUrl}/api/{apiVersion}\` (\u30C7\u30D5\u30A9\u30EB\u30C8\u30D0\u30FC\u30B8\u30E7\u30F3 3.28; https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)
|
|
28299
|
+
- \u8A8D\u8A3C: PAT \u3067\u30B5\u30A4\u30F3\u30A4\u30F3\u3059\u308B\u3068 \`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u3001\u30B5\u30A4\u30C8 ID\u3001\u30E6\u30FC\u30B6\u30FC ID \u304C\u8FD4\u3055\u308C\u308B\u3002Tableau Cloud \u3067\u306F\u7D04 240 \u5206\u306E\u30A2\u30A4\u30C9\u30EB\u3067\u30BB\u30C3\u30B7\u30E7\u30F3\u5931\u52B9
|
|
28300
|
+
- \u30EC\u30B9\u30DD\u30F3\u30B9\u5F62\u5F0F: \`Accept: application/json\` \u3092\u9001\u308B\u3068 JSON (\u30C7\u30D5\u30A9\u30EB\u30C8)\u3002\u9001\u3089\u306A\u3044\u5834\u5408\u306F XML
|
|
28301
|
+
- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: \`?pageSize=&pageNumber=\` \u30AF\u30A8\u30EA\u3002\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`pagination\` \u30AA\u30D6\u30B8\u30A7\u30AF\u30C8
|
|
28302
|
+
|
|
28303
|
+
#### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
|
|
28304
|
+
- POST \`/auth/signin\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3 (\u81EA\u52D5\u51E6\u7406)
|
|
28305
|
+
- POST \`/auth/signout\` \u2014 \u30B5\u30A4\u30F3\u30A2\u30A6\u30C8
|
|
28306
|
+
- GET \`/sites/{siteId}/projects\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7
|
|
28307
|
+
- GET \`/sites/{siteId}/workbooks\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7 (\`filter\`, \`sort\` \u5BFE\u5FDC)
|
|
28308
|
+
- GET \`/sites/{siteId}/workbooks/{workbookId}\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u53D6\u5F97
|
|
28309
|
+
- GET \`/sites/{siteId}/workbooks/{workbookId}/views\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u5185\u306E\u30D3\u30E5\u30FC\u4E00\u89A7
|
|
28310
|
+
- GET \`/sites/{siteId}/views/{viewId}/data\` \u2014 \u30D3\u30E5\u30FC\u30C7\u30FC\u30BF\u3092 CSV \u3067\u53D6\u5F97
|
|
28311
|
+
- GET \`/sites/{siteId}/views/{viewId}/image\` \u2014 \u30D3\u30E5\u30FC\u3092 PNG \u3067\u53D6\u5F97
|
|
28312
|
+
- GET \`/sites/{siteId}/views/{viewId}/pdf\` \u2014 \u30D3\u30E5\u30FC\u3092 PDF \u3067\u53D6\u5F97
|
|
28313
|
+
- GET \`/sites/{siteId}/datasources\` \u2014 \u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7
|
|
28314
|
+
- GET \`/sites/{siteId}/users\` \u2014 \u30E6\u30FC\u30B6\u30FC\u4E00\u89A7
|
|
28315
|
+
- GET \`/sites/{siteId}/groups\` \u2014 \u30B0\u30EB\u30FC\u30D7\u4E00\u89A7
|
|
28316
|
+
|
|
28317
|
+
#### \u30D5\u30A3\u30EB\u30BF\u69CB\u6587
|
|
28318
|
+
- \`filter=name:eq:Sales\` \u2014 \u5B8C\u5168\u4E00\u81F4
|
|
28319
|
+
- \`filter=name:in:[Sales,Marketing]\` \u2014 \u96C6\u5408\u306B\u542B\u307E\u308C\u308B
|
|
28320
|
+
- \`filter=updatedAt:gte:2024-01-01T00:00:00Z\` \u2014 \u6BD4\u8F03\u6F14\u7B97\u5B50 (gt/gte/lt/lte)
|
|
28321
|
+
- \u7D44\u307F\u5408\u308F\u305B: \`filter=ownerName:eq:alice,tags:in:[finance]\``
|
|
28322
|
+
},
|
|
28323
|
+
tools: tools81,
|
|
28324
|
+
async checkConnection(params) {
|
|
28325
|
+
const serverUrl = params[parameters81.serverUrl.slug];
|
|
28326
|
+
const siteContentUrl = params[parameters81.siteContentUrl.slug];
|
|
28327
|
+
const patName = params[parameters81.patName.slug];
|
|
28328
|
+
const patSecret = params[parameters81.patSecret.slug];
|
|
28329
|
+
const apiVersion = params[parameters81.apiVersion.slug] || "3.28";
|
|
28330
|
+
if (!serverUrl || siteContentUrl == null || !patName || !patSecret) {
|
|
28331
|
+
return {
|
|
28332
|
+
success: false,
|
|
28333
|
+
error: "Missing required parameters: server-url, site-content-url, pat-name, pat-secret"
|
|
28334
|
+
};
|
|
28335
|
+
}
|
|
28336
|
+
try {
|
|
28337
|
+
const res = await fetch(
|
|
28338
|
+
`${serverUrl.replace(/\/$/, "")}/api/${apiVersion}/auth/signin`,
|
|
28339
|
+
{
|
|
28340
|
+
method: "POST",
|
|
28341
|
+
headers: {
|
|
28342
|
+
"Content-Type": "application/json",
|
|
28343
|
+
Accept: "application/json"
|
|
28344
|
+
},
|
|
28345
|
+
body: JSON.stringify({
|
|
28346
|
+
credentials: {
|
|
28347
|
+
personalAccessTokenName: patName,
|
|
28348
|
+
personalAccessTokenSecret: patSecret,
|
|
28349
|
+
site: { contentUrl: siteContentUrl }
|
|
28350
|
+
}
|
|
28351
|
+
})
|
|
28352
|
+
}
|
|
28353
|
+
);
|
|
28354
|
+
if (!res.ok) {
|
|
28355
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
28356
|
+
return {
|
|
28357
|
+
success: false,
|
|
28358
|
+
error: `Tableau sign-in failed: HTTP ${res.status} ${errorText}`
|
|
28359
|
+
};
|
|
28360
|
+
}
|
|
28361
|
+
return { success: true };
|
|
28362
|
+
} catch (error) {
|
|
28363
|
+
return {
|
|
28364
|
+
success: false,
|
|
28365
|
+
error: error instanceof Error ? error.message : String(error)
|
|
28366
|
+
};
|
|
28367
|
+
}
|
|
28368
|
+
}
|
|
28369
|
+
});
|
|
28370
|
+
|
|
28371
|
+
// ../connectors/src/connectors/outlook-oauth/tools/request.ts
|
|
28372
|
+
import { z as z99 } from "zod";
|
|
28373
|
+
var BASE_HOST13 = "https://graph.microsoft.com";
|
|
28374
|
+
var BASE_PATH_SEGMENT16 = "/v1.0";
|
|
28375
|
+
var BASE_URL42 = `${BASE_HOST13}${BASE_PATH_SEGMENT16}`;
|
|
28376
|
+
var REQUEST_TIMEOUT_MS76 = 6e4;
|
|
28377
|
+
var cachedToken33 = null;
|
|
28378
|
+
async function getProxyToken33(config) {
|
|
28379
|
+
if (cachedToken33 && cachedToken33.expiresAt > Date.now() + 6e4) {
|
|
28380
|
+
return cachedToken33.token;
|
|
28381
|
+
}
|
|
28382
|
+
const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
|
|
28383
|
+
const res = await fetch(url, {
|
|
28384
|
+
method: "POST",
|
|
28385
|
+
headers: {
|
|
28386
|
+
"Content-Type": "application/json",
|
|
28387
|
+
"x-api-key": config.appApiKey,
|
|
28388
|
+
"project-id": config.projectId
|
|
28389
|
+
},
|
|
28390
|
+
body: JSON.stringify({
|
|
28391
|
+
sandboxId: config.sandboxId,
|
|
28392
|
+
issuedBy: "coding-agent"
|
|
28393
|
+
})
|
|
28394
|
+
});
|
|
28395
|
+
if (!res.ok) {
|
|
28396
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
28397
|
+
throw new Error(
|
|
28398
|
+
`Failed to get proxy token: HTTP ${res.status} ${errorText}`
|
|
28399
|
+
);
|
|
28400
|
+
}
|
|
28401
|
+
const data = await res.json();
|
|
28402
|
+
cachedToken33 = {
|
|
28403
|
+
token: data.token,
|
|
28404
|
+
expiresAt: new Date(data.expiresAt).getTime()
|
|
28405
|
+
};
|
|
28406
|
+
return data.token;
|
|
28407
|
+
}
|
|
28408
|
+
var inputSchema99 = z99.object({
|
|
28409
|
+
toolUseIntent: z99.string().optional().describe(
|
|
28410
|
+
"Brief description of what you intend to accomplish with this tool call"
|
|
28411
|
+
),
|
|
28412
|
+
connectionId: z99.string().describe("ID of the Outlook OAuth connection to use"),
|
|
28413
|
+
method: z99.enum(["GET"]).describe("HTTP method (read-only, GET only)"),
|
|
28414
|
+
path: z99.string().describe(
|
|
28415
|
+
"Microsoft Graph path appended to https://graph.microsoft.com/v1.0. Covers Outlook Mail (e.g. '/me', '/me/messages', '/me/messages/{id}', '/me/mailFolders', '/me/messages/{id}/attachments') and Outlook Calendar (e.g. '/me/calendars', '/me/events', '/me/events/{id}', '/me/calendarView'). Use '/me' as the user prefix."
|
|
28416
|
+
),
|
|
28417
|
+
queryParams: z99.record(z99.string(), z99.string()).optional().describe(
|
|
28418
|
+
`Query parameters to append. Microsoft Graph supports OData operators ($filter, $orderby, $top, $skip, $select, $expand, $search). Examples: { $top: '10', $select: 'subject,from,receivedDateTime' } for mail; { $filter: "conversationId eq '<id>'", $orderby: 'receivedDateTime asc' } for a thread; { startDateTime: '2025-01-15T00:00:00Z', endDateTime: '2025-01-16T00:00:00Z', $orderby: 'start/dateTime' } for calendarView.`
|
|
28419
|
+
)
|
|
28420
|
+
});
|
|
28421
|
+
var outputSchema99 = z99.discriminatedUnion("success", [
|
|
28422
|
+
z99.object({
|
|
28423
|
+
success: z99.literal(true),
|
|
28424
|
+
status: z99.number(),
|
|
28425
|
+
data: z99.record(z99.string(), z99.unknown())
|
|
28426
|
+
}),
|
|
28427
|
+
z99.object({
|
|
28428
|
+
success: z99.literal(false),
|
|
28429
|
+
error: z99.string()
|
|
28430
|
+
})
|
|
28431
|
+
]);
|
|
28432
|
+
var requestTool58 = new ConnectorTool({
|
|
28433
|
+
name: "request",
|
|
28434
|
+
description: `Send authenticated GET requests to Microsoft Graph for Outlook Mail and Calendar.
|
|
28435
|
+
Authentication is handled automatically via OAuth proxy (Microsoft Entra ID).
|
|
28436
|
+
All paths are relative to https://graph.microsoft.com/v1.0. Use '/me' as the user prefix.
|
|
28437
|
+
Covers mailbox (\`/me/messages\`, \`/me/mailFolders\`), threads (\`/me/messages?$filter=conversationId eq '<id>'\`), attachments (\`/me/messages/{id}/attachments\`), calendars (\`/me/calendars\`), and events (\`/me/events\`, \`/me/calendarView\` for expanded occurrences).
|
|
28438
|
+
For full-text search use the \`$search\` query parameter (must be wrapped in double quotes); for filtering use \`$filter\` with OData syntax (e.g., \`receivedDateTime ge 2025-01-01T00:00:00Z\`).`,
|
|
28439
|
+
inputSchema: inputSchema99,
|
|
28440
|
+
outputSchema: outputSchema99,
|
|
28441
|
+
async execute({ connectionId, method, path: path5, queryParams }, connections, config) {
|
|
28442
|
+
const connection = connections.find((c) => c.id === connectionId);
|
|
28443
|
+
if (!connection) {
|
|
28444
|
+
return {
|
|
28445
|
+
success: false,
|
|
28446
|
+
error: `Connection ${connectionId} not found`
|
|
28447
|
+
};
|
|
28448
|
+
}
|
|
28449
|
+
console.log(
|
|
28450
|
+
`[connector-request] outlook-oauth/${connection.name}: ${method} ${path5}`
|
|
28451
|
+
);
|
|
28452
|
+
try {
|
|
28453
|
+
const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT16);
|
|
28454
|
+
let url = `${BASE_URL42}${normalizedPath}`;
|
|
28455
|
+
if (queryParams) {
|
|
28456
|
+
const searchParams = new URLSearchParams(queryParams);
|
|
28457
|
+
url += `?${searchParams.toString()}`;
|
|
28458
|
+
}
|
|
28459
|
+
const token = await getProxyToken33(config.oauthProxy);
|
|
28460
|
+
const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
|
|
28461
|
+
const controller = new AbortController();
|
|
28462
|
+
const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS76);
|
|
28463
|
+
try {
|
|
28464
|
+
const response = await fetch(proxyUrl, {
|
|
28465
|
+
method: "POST",
|
|
28466
|
+
headers: {
|
|
28467
|
+
"Content-Type": "application/json",
|
|
28468
|
+
Authorization: `Bearer ${token}`
|
|
28469
|
+
},
|
|
28470
|
+
body: JSON.stringify({
|
|
28471
|
+
url,
|
|
28472
|
+
method
|
|
28473
|
+
}),
|
|
28474
|
+
signal: controller.signal
|
|
28475
|
+
});
|
|
28476
|
+
const data = await response.json();
|
|
28477
|
+
if (!response.ok) {
|
|
28478
|
+
const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.message === "string" ? data.message : `HTTP ${response.status} ${response.statusText}`;
|
|
28479
|
+
return { success: false, error: errorMessage };
|
|
28480
|
+
}
|
|
28481
|
+
return { success: true, status: response.status, data };
|
|
28482
|
+
} finally {
|
|
28483
|
+
clearTimeout(timeout);
|
|
28484
|
+
}
|
|
28485
|
+
} catch (err) {
|
|
28486
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
28487
|
+
return { success: false, error: msg };
|
|
28488
|
+
}
|
|
28489
|
+
}
|
|
28490
|
+
});
|
|
28491
|
+
|
|
28492
|
+
// ../connectors/src/connectors/outlook-oauth/setup.ts
|
|
28493
|
+
var requestToolName14 = `outlook-oauth_${requestTool58.name}`;
|
|
28494
|
+
var outlookOnboarding = new ConnectorOnboarding({
|
|
28495
|
+
connectionSetupInstructions: {
|
|
28496
|
+
ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067 Outlook \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
|
|
28497
|
+
|
|
28498
|
+
1. \`${requestToolName14}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u8A8D\u8A3C\u6E08\u307F\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u3092\u53D6\u5F97\u3059\u308B:
|
|
28499
|
+
- \`method\`: \`"GET"\`
|
|
28500
|
+
- \`path\`: \`"/me"\`
|
|
28501
|
+
2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u306F\u3001OAuth \u8A8D\u8A3C\u304C\u6B63\u3057\u304F\u5B8C\u4E86\u3057\u3066\u3044\u308B\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B
|
|
28502
|
+
3. \`${requestToolName14}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B:
|
|
28503
|
+
- \`method\`: \`"GET"\`
|
|
28504
|
+
- \`path\`: \`"/me/mailFolders"\`
|
|
28505
|
+
|
|
28506
|
+
#### \u5236\u7D04
|
|
28507
|
+
- **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B\u30E1\u30C3\u30BB\u30FC\u30B8\u672C\u6587\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u53D6\u5F97\u3068\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u53D6\u5F97\u306E\u307F
|
|
28508
|
+
- \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057`,
|
|
28509
|
+
en: `Follow these steps to set up the Outlook connection.
|
|
28510
|
+
|
|
28511
|
+
1. Call \`${requestToolName14}\` to get the authenticated user's profile:
|
|
28512
|
+
- \`method\`: \`"GET"\`
|
|
28513
|
+
- \`path\`: \`"/me"\`
|
|
28514
|
+
2. If an error is returned, ask the user to verify that OAuth authentication completed correctly
|
|
28515
|
+
3. Call \`${requestToolName14}\` to get the mail folder list:
|
|
28516
|
+
- \`method\`: \`"GET"\`
|
|
28517
|
+
- \`path\`: \`"/me/mailFolders"\`
|
|
28518
|
+
|
|
28519
|
+
#### Constraints
|
|
28520
|
+
- **Do NOT read message bodies during setup**. Only the profile and mail-folder requests specified above are allowed
|
|
28521
|
+
- Write only 1 sentence between tool calls, then immediately call the next tool`
|
|
28522
|
+
},
|
|
28523
|
+
dataOverviewInstructions: {
|
|
28524
|
+
en: `Mail
|
|
28525
|
+
1. Call outlook-oauth_request with GET /me/mailFolders to list mail folders
|
|
28526
|
+
2. Call outlook-oauth_request with GET /me/messages?$top=5&$select=id,subject,from,receivedDateTime,conversationId to sample recent messages
|
|
28527
|
+
3. Call outlook-oauth_request with GET /me/messages/{id} for an interesting message to inspect the full payload
|
|
28528
|
+
4. Call outlook-oauth_request with GET /me/mailFolders/{folderId}/messages?$top=5 to drill into a specific folder
|
|
28529
|
+
5. For threading, call outlook-oauth_request with GET /me/messages?$filter=conversationId%20eq%20'<id>'&$orderby=receivedDateTime%20asc to pull every message in a conversation
|
|
28530
|
+
|
|
28531
|
+
Calendar
|
|
28532
|
+
6. Call outlook-oauth_request with GET /me/calendars to list calendars (default + shared)
|
|
28533
|
+
7. Call outlook-oauth_request with GET /me/calendarView?startDateTime=<startISO>&endDateTime=<endISO>&$top=5&$select=id,subject,start,end,attendees to sample upcoming occurrences (expands recurring events)
|
|
28534
|
+
8. Call outlook-oauth_request with GET /me/events/{eventId} for an interesting event to inspect attendees, body, and location`,
|
|
28535
|
+
ja: `\u30E1\u30FC\u30EB
|
|
28536
|
+
1. outlook-oauth_request \u3067 GET /me/mailFolders \u3092\u547C\u3073\u51FA\u3057\u3001\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3092\u53D6\u5F97
|
|
28537
|
+
2. outlook-oauth_request \u3067 GET /me/messages?$top=5&$select=id,subject,from,receivedDateTime,conversationId \u3092\u547C\u3073\u51FA\u3057\u3001\u6700\u65B0\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
|
|
28538
|
+
3. \u8208\u5473\u306E\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3064\u3044\u3066 outlook-oauth_request \u3067 GET /me/messages/{id} \u3092\u547C\u3073\u51FA\u3057\u3001\u30DA\u30A4\u30ED\u30FC\u30C9\u5168\u4F53\u3092\u78BA\u8A8D
|
|
28539
|
+
4. outlook-oauth_request \u3067 GET /me/mailFolders/{folderId}/messages?$top=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u7279\u5B9A\u30D5\u30A9\u30EB\u30C0\u306E\u4E2D\u8EAB\u3092\u78BA\u8A8D
|
|
28540
|
+
5. \u30B9\u30EC\u30C3\u30C9\u3092\u8FFD\u3046\u5834\u5408\u306F outlook-oauth_request \u3067 GET /me/messages?$filter=conversationId%20eq%20'<id>'&$orderby=receivedDateTime%20asc \u3092\u547C\u3073\u51FA\u3057\u3001\u4F1A\u8A71\u306B\u542B\u307E\u308C\u308B\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97
|
|
28541
|
+
|
|
28542
|
+
\u30AB\u30EC\u30F3\u30C0\u30FC
|
|
28543
|
+
6. outlook-oauth_request \u3067 GET /me/calendars \u3092\u547C\u3073\u51FA\u3057\u3001\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7 (\u30C7\u30D5\u30A9\u30EB\u30C8 + \u5171\u6709) \u3092\u53D6\u5F97
|
|
28544
|
+
7. outlook-oauth_request \u3067 GET /me/calendarView?startDateTime=<startISO>&endDateTime=<endISO>&$top=5&$select=id,subject,start,end,attendees \u3092\u547C\u3073\u51FA\u3057\u3001\u76F4\u8FD1\u306E occurrence \u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0 (\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u3092\u5C55\u958B)
|
|
28545
|
+
8. \u8208\u5473\u306E\u3042\u308B\u30A4\u30D9\u30F3\u30C8\u306B\u3064\u3044\u3066 outlook-oauth_request \u3067 GET /me/events/{eventId} \u3092\u547C\u3073\u51FA\u3057\u3001\u53C2\u52A0\u8005\u30FB\u672C\u6587\u30FB\u5834\u6240\u3092\u78BA\u8A8D`
|
|
28546
|
+
}
|
|
28547
|
+
});
|
|
28548
|
+
|
|
28549
|
+
// ../connectors/src/connectors/outlook-oauth/parameters.ts
|
|
28550
|
+
var parameters82 = {};
|
|
28551
|
+
|
|
28552
|
+
// ../connectors/src/connectors/outlook-oauth/index.ts
|
|
28553
|
+
var tools82 = { request: requestTool58 };
|
|
28554
|
+
var outlookOauthConnector = new ConnectorPlugin({
|
|
28555
|
+
slug: "outlook",
|
|
28556
|
+
authType: AUTH_TYPES.OAUTH,
|
|
28557
|
+
name: "Outlook",
|
|
28558
|
+
description: "Connect to Microsoft Outlook (Mail + Calendar) via Microsoft Graph using OAuth. Read-only access to the user's mailbox, mail folders, messages, attachments, calendars, and events.",
|
|
28559
|
+
iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/1J1FrRTYJjOh3CcSIqsz3I/6a467b4d926075ff99dc60820e0ae4b1/Microsoft_Outlook_Icon__2025%C3%A2__present_.svg",
|
|
28560
|
+
parameters: parameters82,
|
|
28561
|
+
releaseFlag: { dev1: true, dev2: false, prod: false },
|
|
28562
|
+
categories: ["productivity"],
|
|
28563
|
+
onboarding: outlookOnboarding,
|
|
28564
|
+
proxyPolicy: {
|
|
28565
|
+
allowlist: [
|
|
28566
|
+
{
|
|
28567
|
+
host: "graph.microsoft.com",
|
|
28568
|
+
methods: ["GET"]
|
|
28569
|
+
}
|
|
28570
|
+
]
|
|
28571
|
+
},
|
|
28572
|
+
systemPrompt: {
|
|
28573
|
+
en: `### Tools
|
|
28574
|
+
|
|
28575
|
+
- \`outlook-oauth_request\`: The only way to call Microsoft Graph for Outlook (read-only). Use it to fetch the user profile (\`/me\`), list mail folders (\`/me/mailFolders\`), read messages (\`/me/messages\`, \`/me/messages/{id}\`), fetch attachments (\`/me/messages/{id}/attachments\`), list calendars (\`/me/calendars\`), and read events (\`/me/events\`, \`/me/calendarView\`). Authentication is configured automatically via OAuth.
|
|
28576
|
+
|
|
28577
|
+
### Microsoft Graph Reference (Outlook Mail)
|
|
28578
|
+
|
|
28579
|
+
#### Available Endpoints
|
|
28580
|
+
- GET \`/me\` \u2014 Get the signed-in user's profile (displayName, mail, userPrincipalName)
|
|
28581
|
+
- GET \`/me/mailFolders\` \u2014 List the user's mail folders (Inbox, SentItems, Drafts, etc.)
|
|
28582
|
+
- GET \`/me/mailFolders/{folderId}\` \u2014 Get a specific mail folder
|
|
28583
|
+
- GET \`/me/mailFolders/{folderId}/messages\` \u2014 List messages within a folder
|
|
28584
|
+
- GET \`/me/messages\` \u2014 List messages across all folders
|
|
28585
|
+
- GET \`/me/messages/{id}\` \u2014 Get a specific message with full body
|
|
28586
|
+
- GET \`/me/messages/{id}/attachments\` \u2014 List attachments on a message
|
|
28587
|
+
- GET \`/me/messages/{id}/attachments/{attachmentId}\` \u2014 Get a specific attachment
|
|
28588
|
+
|
|
28589
|
+
#### Well-Known Folder Names (usable in place of {folderId})
|
|
28590
|
+
- \`inbox\`, \`sentitems\`, \`drafts\`, \`deleteditems\`, \`junkemail\`, \`outbox\`, \`archive\`
|
|
28591
|
+
|
|
28592
|
+
#### Conversations (Threads)
|
|
28593
|
+
- Every message has a \`conversationId\`. Fetch all messages in a thread with: GET \`/me/messages?$filter=conversationId eq '<id>'&$orderby=receivedDateTime asc\` (Gmail-style \`getThread\` equivalent).
|
|
28594
|
+
|
|
28595
|
+
### Microsoft Graph Reference (Outlook Calendar)
|
|
28596
|
+
|
|
28597
|
+
#### Available Endpoints
|
|
28598
|
+
- GET \`/me/calendars\` \u2014 List the user's calendars (default + any shared/group calendars)
|
|
28599
|
+
- GET \`/me/calendars/{calendarId}\` \u2014 Get a calendar's metadata
|
|
28600
|
+
- GET \`/me/events\` \u2014 List events on the default calendar (recurring events are returned as series masters \u2014 use \`/me/calendarView\` to expand)
|
|
28601
|
+
- GET \`/me/calendars/{calendarId}/events\` \u2014 List events on a specific calendar
|
|
28602
|
+
- GET \`/me/events/{eventId}\` \u2014 Get a single event
|
|
28603
|
+
- GET \`/me/calendarView?startDateTime=&endDateTime=\` \u2014 List event **occurrences** in a date range (expands recurring events). Equivalent to Google Calendar's \`events?singleEvents=true\`
|
|
28604
|
+
- GET \`/me/calendars/{calendarId}/calendarView?startDateTime=&endDateTime=\` \u2014 Same, scoped to a specific calendar
|
|
28605
|
+
|
|
28606
|
+
#### Calendar Tips
|
|
28607
|
+
- Use \`/me/calendarView\` when you want individual occurrences of recurring events; \`/me/events\` is closer to the raw stored series
|
|
28608
|
+
- \`startDateTime\` / \`endDateTime\` must be ISO-8601 UTC, e.g. \`2025-01-15T00:00:00Z\`
|
|
28609
|
+
- Combine with \`$select=subject,start,end,attendees,location\` and \`$orderby=start/dateTime\` to keep responses small and sorted
|
|
28610
|
+
|
|
28611
|
+
#### Key Query Parameters (OData, shared by Mail + Calendar)
|
|
28612
|
+
- \`$top\` \u2014 Maximum number of results (default 10, max 1000)
|
|
28613
|
+
- \`$skip\` \u2014 Skip the first N results (for paging)
|
|
28614
|
+
- \`$select\` \u2014 Comma-separated list of properties (e.g. \`subject,from,receivedDateTime,bodyPreview\`)
|
|
28615
|
+
- \`$orderby\` \u2014 Sort (e.g. \`receivedDateTime desc\`, \`start/dateTime asc\`)
|
|
28616
|
+
- \`$filter\` \u2014 OData filter (e.g. \`receivedDateTime ge 2025-01-01T00:00:00Z\`, \`from/emailAddress/address eq 'a@b.com'\`, \`isRead eq false\`, \`conversationId eq '<id>'\`, \`start/dateTime ge '2025-01-15T00:00:00'\`)
|
|
28617
|
+
- \`$search\` \u2014 Full-text search; must be wrapped in double quotes (e.g. \`$search="project status"\`). \`$search\` and \`$filter\` cannot be combined
|
|
28618
|
+
- \`$expand\` \u2014 Expand related resources (e.g. \`attachments\`, \`instances\` for recurring events)
|
|
28619
|
+
- \`$count=true\` \u2014 Return total count (requires \`ConsistencyLevel: eventual\` header on some endpoints)
|
|
28620
|
+
|
|
28621
|
+
#### Pagination
|
|
28622
|
+
- Responses include \`@odata.nextLink\` when more results exist; call that URL (or its path) to get the next page
|
|
28623
|
+
|
|
28624
|
+
#### Tips
|
|
28625
|
+
- Use \`/me\` for the signed-in user \u2014 never substitute another user ID
|
|
28626
|
+
- Prefer \`$select\` to avoid huge payloads; the full message body can be MB-sized when HTML
|
|
28627
|
+
- \`bodyPreview\` (first ~255 chars) is included by default and is cheap for triage
|
|
28628
|
+
- Date/time values are ISO-8601; calendar event times also include a \`timeZone\` field
|
|
28629
|
+
|
|
28630
|
+
### Business Logic
|
|
28631
|
+
|
|
28632
|
+
The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables and do NOT read \`INTERNAL_SQUADBASE_*\` env vars \u2014 the SDK takes care of OAuth.
|
|
28633
|
+
|
|
28634
|
+
SDK surface (client created via \`connection(connectionId)\`):
|
|
28635
|
+
|
|
28636
|
+
Mail:
|
|
28637
|
+
- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path appended to \`https://graph.microsoft.com/v1.0\`)
|
|
28638
|
+
- \`client.getProfile()\` \u2014 fetch the authenticated user's profile
|
|
28639
|
+
- \`client.listMailFolders()\` \u2014 list all mail folders
|
|
28640
|
+
- \`client.listMessages(options?)\` \u2014 list messages with optional \`top\`, \`skip\`, \`filter\`, \`orderBy\`, \`select\`, \`search\`
|
|
28641
|
+
- \`client.listMessagesInFolder(folderId, options?)\` \u2014 list messages in a folder (well-known names like \`inbox\` work)
|
|
28642
|
+
- \`client.getMessage(id, options?)\` \u2014 fetch a specific message
|
|
28643
|
+
- \`client.listConversation(conversationId, options?)\` \u2014 fetch every message in a thread (Gmail-style \`getThread\` equivalent; orders oldest-first by default)
|
|
28644
|
+
|
|
28645
|
+
Attachments:
|
|
28646
|
+
- \`client.listAttachments(messageId)\` \u2014 list attachments on a message
|
|
28647
|
+
- \`client.getAttachment(messageId, attachmentId)\` \u2014 fetch a single attachment (file attachments include base64 \`contentBytes\`)
|
|
28648
|
+
|
|
28649
|
+
Calendar:
|
|
28650
|
+
- \`client.listCalendars()\` \u2014 list calendars accessible to the user
|
|
28651
|
+
- \`client.listEvents(options?)\` \u2014 list events on the default calendar (or pass \`{ calendarId }\` for a specific one). Recurring events are returned as series masters
|
|
28652
|
+
- \`client.getEvent(id)\` \u2014 fetch a single event
|
|
28653
|
+
- \`client.listCalendarView(startDateTime, endDateTime, options?)\` \u2014 list event **occurrences** in a date range (recurring events expanded). Equivalent to Google Calendar's \`events?singleEvents=true\`
|
|
28654
|
+
|
|
28655
|
+
If a handler test fails with \`Connection proxy is not configured\`, retry \u2014 the sandbox is still initializing. Do NOT abandon the SDK and construct OAuth proxy URLs manually.
|
|
28656
|
+
|
|
28657
|
+
#### Example
|
|
28658
|
+
|
|
28659
|
+
\`\`\`ts
|
|
28660
|
+
import { connection } from "@squadbase/vite-server/connectors/outlook-oauth";
|
|
28661
|
+
|
|
28662
|
+
const outlook = connection("<connectionId>");
|
|
28663
|
+
|
|
28664
|
+
// Get user profile
|
|
28665
|
+
const profile = await outlook.getProfile();
|
|
28666
|
+
console.log(profile.displayName, profile.mail);
|
|
28667
|
+
|
|
28668
|
+
// List recent unread messages in Inbox
|
|
28669
|
+
const messages = await outlook.listMessagesInFolder("inbox", {
|
|
28670
|
+
top: 10,
|
|
28671
|
+
filter: "isRead eq false",
|
|
28672
|
+
orderBy: "receivedDateTime desc",
|
|
28673
|
+
select: ["id", "subject", "from", "receivedDateTime", "bodyPreview", "conversationId"],
|
|
28674
|
+
});
|
|
28675
|
+
for (const msg of messages.value) {
|
|
28676
|
+
console.log(msg.receivedDateTime, msg.from?.emailAddress.address, msg.subject);
|
|
28677
|
+
}
|
|
28678
|
+
|
|
28679
|
+
// Pull a whole conversation
|
|
28680
|
+
const first = messages.value[0];
|
|
28681
|
+
if (first?.conversationId) {
|
|
28682
|
+
const thread = await outlook.listConversation(first.conversationId);
|
|
28683
|
+
thread.value.forEach(m => console.log(m.receivedDateTime, m.bodyPreview));
|
|
28684
|
+
}
|
|
28685
|
+
|
|
28686
|
+
// Fetch attachments on a message that has them
|
|
28687
|
+
if (first?.hasAttachments) {
|
|
28688
|
+
const atts = await outlook.listAttachments(first.id);
|
|
28689
|
+
for (const a of atts.value) {
|
|
28690
|
+
const full = await outlook.getAttachment(first.id, a.id);
|
|
28691
|
+
console.log(full.name, full.contentType, full.size);
|
|
28692
|
+
// full.contentBytes is base64 for file attachments
|
|
28693
|
+
}
|
|
28694
|
+
}
|
|
28695
|
+
|
|
28696
|
+
// List today's calendar events (expanded occurrences)
|
|
28697
|
+
const todayStart = new Date(); todayStart.setHours(0, 0, 0, 0);
|
|
28698
|
+
const todayEnd = new Date(todayStart); todayEnd.setDate(todayEnd.getDate() + 1);
|
|
28699
|
+
const events = await outlook.listCalendarView(
|
|
28700
|
+
todayStart.toISOString(),
|
|
28701
|
+
todayEnd.toISOString(),
|
|
28702
|
+
{ orderBy: "start/dateTime", select: ["id", "subject", "start", "end", "attendees"] },
|
|
28703
|
+
);
|
|
28704
|
+
events.value.forEach(e => console.log(e.start.dateTime, e.subject));
|
|
28705
|
+
\`\`\``,
|
|
28706
|
+
ja: `### \u30C4\u30FC\u30EB
|
|
28707
|
+
|
|
28708
|
+
- \`outlook-oauth_request\`: Outlook \u5411\u3051\u306E Microsoft Graph \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\uFF08\u8AAD\u307F\u53D6\u308A\u5C02\u7528\uFF09\u3002\u30E6\u30FC\u30B6\u30FC\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB (\`/me\`)\u3001\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0 (\`/me/mailFolders\`)\u3001\u30E1\u30C3\u30BB\u30FC\u30B8 (\`/me/messages\`)\u3001\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB (\`/me/messages/{id}/attachments\`)\u3001\u30AB\u30EC\u30F3\u30C0\u30FC (\`/me/calendars\`)\u3001\u30A4\u30D9\u30F3\u30C8 (\`/me/events\`, \`/me/calendarView\`) \u306E\u53D6\u5F97\u306B\u4F7F\u3044\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
|
|
28709
|
+
|
|
28710
|
+
### Microsoft Graph \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9 (Outlook \u30E1\u30FC\u30EB)
|
|
28711
|
+
|
|
28712
|
+
#### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
|
|
28713
|
+
- GET \`/me\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB (displayName, mail, userPrincipalName)
|
|
28714
|
+
- GET \`/me/mailFolders\` \u2014 \u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7 (Inbox, SentItems, Drafts \u306A\u3069)
|
|
28715
|
+
- GET \`/me/mailFolders/{folderId}\` \u2014 \u7279\u5B9A\u30D5\u30A9\u30EB\u30C0\u306E\u53D6\u5F97
|
|
28716
|
+
- GET \`/me/mailFolders/{folderId}/messages\` \u2014 \u30D5\u30A9\u30EB\u30C0\u5185\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7
|
|
28717
|
+
- GET \`/me/messages\` \u2014 \u5168\u30D5\u30A9\u30EB\u30C0\u6A2A\u65AD\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7
|
|
28718
|
+
- GET \`/me/messages/{id}\` \u2014 \u7279\u5B9A\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u672C\u6587\u8FBC\u307F\u3067\u53D6\u5F97
|
|
28719
|
+
- GET \`/me/messages/{id}/attachments\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u4E00\u89A7
|
|
28720
|
+
- GET \`/me/messages/{id}/attachments/{attachmentId}\` \u2014 \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u5358\u4F53\u53D6\u5F97
|
|
28721
|
+
|
|
28722
|
+
#### Well-Known \u30D5\u30A9\u30EB\u30C0\u540D ({folderId} \u306E\u4EE3\u308F\u308A\u306B\u4F7F\u7528\u53EF\u80FD)
|
|
28723
|
+
- \`inbox\`, \`sentitems\`, \`drafts\`, \`deleteditems\`, \`junkemail\`, \`outbox\`, \`archive\`
|
|
28724
|
+
|
|
28725
|
+
#### \u4F1A\u8A71 (\u30B9\u30EC\u30C3\u30C9)
|
|
28726
|
+
- \u3059\u3079\u3066\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u306F \`conversationId\` \u3092\u6301\u3064\u3002\u30B9\u30EC\u30C3\u30C9\u5185\u306E\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F: GET \`/me/messages?$filter=conversationId eq '<id>'&$orderby=receivedDateTime asc\` (Gmail \u306E \`getThread\` \u76F8\u5F53)\u3002
|
|
28727
|
+
|
|
28728
|
+
### Microsoft Graph \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9 (Outlook \u30AB\u30EC\u30F3\u30C0\u30FC)
|
|
28729
|
+
|
|
28730
|
+
#### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
|
|
28731
|
+
- GET \`/me/calendars\` \u2014 \u30E6\u30FC\u30B6\u30FC\u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7 (\u30C7\u30D5\u30A9\u30EB\u30C8 + \u5171\u6709/\u30B0\u30EB\u30FC\u30D7\u30AB\u30EC\u30F3\u30C0\u30FC)
|
|
28732
|
+
- GET \`/me/calendars/{calendarId}\` \u2014 \u30AB\u30EC\u30F3\u30C0\u30FC\u5358\u4F53\u53D6\u5F97
|
|
28733
|
+
- GET \`/me/events\` \u2014 \u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7\uFF08\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306F series master \u306E\u307E\u307E\u8FD4\u308B \u2014 \u5C55\u958B\u3057\u305F\u3044\u5834\u5408\u306F \`/me/calendarView\`\uFF09
|
|
28734
|
+
- GET \`/me/calendars/{calendarId}/events\` \u2014 \u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7
|
|
28735
|
+
- GET \`/me/events/{eventId}\` \u2014 \u30A4\u30D9\u30F3\u30C8\u5358\u4F53\u53D6\u5F97
|
|
28736
|
+
- GET \`/me/calendarView?startDateTime=&endDateTime=\` \u2014 \u65E5\u4ED8\u7BC4\u56F2\u5185\u306E\u30A4\u30D9\u30F3\u30C8 **occurrence** \u4E00\u89A7\uFF08\u7E70\u308A\u8FD4\u3057\u3092\u5C55\u958B\uFF09\u3002Google Calendar \u306E \`events?singleEvents=true\` \u76F8\u5F53
|
|
28737
|
+
- GET \`/me/calendars/{calendarId}/calendarView?startDateTime=&endDateTime=\` \u2014 \u540C\u4E0A\u3001\u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u7248
|
|
28738
|
+
|
|
28739
|
+
#### \u30AB\u30EC\u30F3\u30C0\u30FC Tips
|
|
28740
|
+
- \u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306E\u500B\u5225 occurrence \u304C\u6B32\u3057\u3044\u5834\u5408\u306F \`/me/calendarView\`\u3001\u751F\u306E\u30B7\u30EA\u30FC\u30BA\u304C\u6B32\u3057\u3044\u5834\u5408\u306F \`/me/events\`
|
|
28741
|
+
- \`startDateTime\` / \`endDateTime\` \u306F ISO-8601 UTC\u3001\u4F8B \`2025-01-15T00:00:00Z\`
|
|
28742
|
+
- \`$select=subject,start,end,attendees,location\` \u3068 \`$orderby=start/dateTime\` \u3092\u7D44\u307F\u5408\u308F\u305B\u308B\u3068\u30DA\u30A4\u30ED\u30FC\u30C9\u6291\u5236 + \u30BD\u30FC\u30C8\u3067\u304D\u308B
|
|
28743
|
+
|
|
28744
|
+
#### \u4E3B\u8981\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (OData; Mail \u3068 Calendar \u3067\u5171\u901A)
|
|
28745
|
+
- \`$top\` \u2014 \u6700\u5927\u7D50\u679C\u6570 (\u30C7\u30D5\u30A9\u30EB\u30C8 10\u3001\u6700\u5927 1000)
|
|
28746
|
+
- \`$skip\` \u2014 \u5148\u982D N \u4EF6\u3092\u30B9\u30AD\u30C3\u30D7 (\u30DA\u30FC\u30B8\u30F3\u30B0)
|
|
28747
|
+
- \`$select\` \u2014 \u53D6\u5F97\u3059\u308B\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u30AB\u30F3\u30DE\u533A\u5207\u308A (\u4F8B \`subject,from,receivedDateTime,bodyPreview\`)
|
|
28748
|
+
- \`$orderby\` \u2014 \u30BD\u30FC\u30C8 (\u4F8B \`receivedDateTime desc\`\u3001\`start/dateTime asc\`)
|
|
28749
|
+
- \`$filter\` \u2014 OData \u30D5\u30A3\u30EB\u30BF (\u4F8B \`receivedDateTime ge 2025-01-01T00:00:00Z\`\u3001\`from/emailAddress/address eq 'a@b.com'\`\u3001\`isRead eq false\`\u3001\`conversationId eq '<id>'\`\u3001\`start/dateTime ge '2025-01-15T00:00:00'\`)
|
|
28750
|
+
- \`$search\` \u2014 \u5168\u6587\u691C\u7D22\u3002\u30C0\u30D6\u30EB\u30AF\u30A9\u30FC\u30C8\u3067\u56F2\u3080\u5FC5\u8981\u3042\u308A (\u4F8B \`$search="project status"\`)\u3002\`$filter\` \u3068\u4F75\u7528\u4E0D\u53EF
|
|
28751
|
+
- \`$expand\` \u2014 \u95A2\u9023\u30EA\u30BD\u30FC\u30B9\u3092\u5C55\u958B (\u4F8B \`attachments\`\u3001\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306E \`instances\`)
|
|
28752
|
+
- \`$count=true\` \u2014 \u7DCF\u4EF6\u6570\u3092\u8FD4\u3059 (\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u3063\u3066\u306F \`ConsistencyLevel: eventual\` \u30D8\u30C3\u30C0\u30FC\u304C\u5FC5\u8981)
|
|
28753
|
+
|
|
28754
|
+
#### \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3
|
|
28755
|
+
- \u7D9A\u304D\u304C\u3042\u308B\u5834\u5408\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`@odata.nextLink\` \u304C\u542B\u307E\u308C\u308B\u3002\u305D\u306E URL (\u307E\u305F\u306F\u30D1\u30B9) \u3092\u547C\u3073\u51FA\u3057\u3066\u6B21\u30DA\u30FC\u30B8\u3092\u53D6\u5F97
|
|
28756
|
+
|
|
28757
|
+
#### Tips
|
|
28758
|
+
- \u30B5\u30A4\u30F3\u30A4\u30F3\u30E6\u30FC\u30B6\u30FC\u306B\u306F\u5FC5\u305A \`/me\` \u3092\u4F7F\u7528 \u2014 \u4ED6\u30E6\u30FC\u30B6\u30FC\u306E ID \u3092\u5165\u308C\u306A\u3044
|
|
28759
|
+
- \u30DA\u30A4\u30ED\u30FC\u30C9\u80A5\u5927\u5316\u3092\u907F\u3051\u308B\u305F\u3081 \`$select\` \u3092\u6D3B\u7528\u3002HTML \u672C\u6587\u8FBC\u307F\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u306F MB \u5358\u4F4D\u306B\u306A\u308B\u3053\u3068\u304C\u3042\u308B
|
|
28760
|
+
- \`bodyPreview\` (\u5148\u982D\u7D04 255 \u6587\u5B57) \u306F\u30C7\u30D5\u30A9\u30EB\u30C8\u3067\u542B\u307E\u308C\u3066\u304A\u308A\u3001\u30C8\u30EA\u30A2\u30FC\u30B8\u306B\u4FBF\u5229
|
|
28761
|
+
- \u65E5\u6642\u5024\u306F ISO-8601\u3002\u30AB\u30EC\u30F3\u30C0\u30FC\u30A4\u30D9\u30F3\u30C8\u306B\u306F \`timeZone\` \u30D5\u30A3\u30FC\u30EB\u30C9\u3082\u542B\u307E\u308C\u308B
|
|
28762
|
+
|
|
28763
|
+
### Business Logic
|
|
28764
|
+
|
|
28765
|
+
\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\`INTERNAL_SQUADBASE_*\` \u306E\u74B0\u5883\u5909\u6570\u3092\u4F7F\u3063\u3066\u624B\u52D5\u3067 OAuth \u30D7\u30ED\u30AD\u30B7\u3092\u53E9\u304F\u3053\u3068\u3082\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044 \u2014 SDK \u304C OAuth \u3092\u51E6\u7406\u3057\u307E\u3059\u3002
|
|
28766
|
+
|
|
28767
|
+
SDK (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
|
|
28768
|
+
|
|
28769
|
+
\u30E1\u30FC\u30EB:
|
|
28770
|
+
- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`https://graph.microsoft.com/v1.0\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059)
|
|
28771
|
+
- \`client.getProfile()\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u3092\u53D6\u5F97
|
|
28772
|
+
- \`client.listMailFolders()\` \u2014 \u5168\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u3092\u4E00\u89A7
|
|
28773
|
+
- \`client.listMessages(options?)\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7 (\`top\`, \`skip\`, \`filter\`, \`orderBy\`, \`select\`, \`search\` \u5BFE\u5FDC)
|
|
28774
|
+
- \`client.listMessagesInFolder(folderId, options?)\` \u2014 \u30D5\u30A9\u30EB\u30C0\u5185\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7 (\`inbox\` \u306A\u3069\u306E well-known \u540D\u3082\u4F7F\u7528\u53EF)
|
|
28775
|
+
- \`client.getMessage(id, options?)\` \u2014 \u7279\u5B9A\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97
|
|
28776
|
+
- \`client.listConversation(conversationId, options?)\` \u2014 \u30B9\u30EC\u30C3\u30C9\u5185\u306E\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97 (Gmail \`getThread\` \u76F8\u5F53\u3001\u30C7\u30D5\u30A9\u30EB\u30C8\u3067\u53E4\u3044\u9806)
|
|
28777
|
+
|
|
28778
|
+
\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB:
|
|
28779
|
+
- \`client.listAttachments(messageId)\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u4E00\u89A7
|
|
28780
|
+
- \`client.getAttachment(messageId, attachmentId)\` \u2014 \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u5358\u4F53\u53D6\u5F97 (file attachment \u306F base64 \u306E \`contentBytes\` \u3092\u542B\u3080)
|
|
28781
|
+
|
|
28782
|
+
\u30AB\u30EC\u30F3\u30C0\u30FC:
|
|
28783
|
+
- \`client.listCalendars()\` \u2014 \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7
|
|
28784
|
+
- \`client.listEvents(options?)\` \u2014 \u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7 (\`{ calendarId }\` \u3067\u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u6307\u5B9A\u53EF)\u3002\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306F series master \u3068\u3057\u3066\u8FD4\u5374
|
|
28785
|
+
- \`client.getEvent(id)\` \u2014 \u30A4\u30D9\u30F3\u30C8\u5358\u4F53\u53D6\u5F97
|
|
28786
|
+
- \`client.listCalendarView(startDateTime, endDateTime, options?)\` \u2014 \u65E5\u4ED8\u7BC4\u56F2\u5185\u306E\u30A4\u30D9\u30F3\u30C8 **occurrence** \u4E00\u89A7 (\u7E70\u308A\u8FD4\u3057\u3092\u5C55\u958B)\u3002Google Calendar \u306E \`events?singleEvents=true\` \u76F8\u5F53
|
|
28787
|
+
|
|
28788
|
+
\u30CF\u30F3\u30C9\u30E9\u306E\u30C6\u30B9\u30C8\u304C \`Connection proxy is not configured\` \u3067\u5931\u6557\u3059\u308B\u5834\u5408\u306F\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002SDK \u3092\u8AE6\u3081\u3066 OAuth \u30D7\u30ED\u30AD\u30B7\u306E URL \u3092\u81EA\u5206\u3067\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u306F **\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044**\u3002
|
|
28789
|
+
|
|
28790
|
+
#### Example
|
|
28791
|
+
|
|
28792
|
+
\`\`\`ts
|
|
28793
|
+
import { connection } from "@squadbase/vite-server/connectors/outlook-oauth";
|
|
28794
|
+
|
|
28795
|
+
const outlook = connection("<connectionId>");
|
|
28796
|
+
|
|
28797
|
+
// \u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u53D6\u5F97
|
|
28798
|
+
const profile = await outlook.getProfile();
|
|
28799
|
+
console.log(profile.displayName, profile.mail);
|
|
28800
|
+
|
|
28801
|
+
// \u53D7\u4FE1\u30C8\u30EC\u30A4\u306E\u672A\u8AAD\u30E1\u30C3\u30BB\u30FC\u30B8\u6700\u65B010\u4EF6
|
|
28802
|
+
const messages = await outlook.listMessagesInFolder("inbox", {
|
|
28803
|
+
top: 10,
|
|
28804
|
+
filter: "isRead eq false",
|
|
28805
|
+
orderBy: "receivedDateTime desc",
|
|
28806
|
+
select: ["id", "subject", "from", "receivedDateTime", "bodyPreview", "conversationId"],
|
|
28807
|
+
});
|
|
28808
|
+
for (const msg of messages.value) {
|
|
28809
|
+
console.log(msg.receivedDateTime, msg.from?.emailAddress.address, msg.subject);
|
|
28810
|
+
}
|
|
28811
|
+
|
|
28812
|
+
// \u30B9\u30EC\u30C3\u30C9\u5168\u4F53\u3092\u53D6\u5F97
|
|
28813
|
+
const first = messages.value[0];
|
|
28814
|
+
if (first?.conversationId) {
|
|
28815
|
+
const thread = await outlook.listConversation(first.conversationId);
|
|
28816
|
+
thread.value.forEach(m => console.log(m.receivedDateTime, m.bodyPreview));
|
|
28817
|
+
}
|
|
28818
|
+
|
|
28819
|
+
// \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u53D6\u5F97
|
|
28820
|
+
if (first?.hasAttachments) {
|
|
28821
|
+
const atts = await outlook.listAttachments(first.id);
|
|
28822
|
+
for (const a of atts.value) {
|
|
28823
|
+
const full = await outlook.getAttachment(first.id, a.id);
|
|
28824
|
+
console.log(full.name, full.contentType, full.size);
|
|
28825
|
+
// full.contentBytes \u306F file attachment \u306E\u5834\u5408 base64
|
|
28826
|
+
}
|
|
28827
|
+
}
|
|
28828
|
+
|
|
28829
|
+
// \u4ECA\u65E5\u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u30A4\u30D9\u30F3\u30C8 (occurrence \u5C55\u958B)
|
|
28830
|
+
const todayStart = new Date(); todayStart.setHours(0, 0, 0, 0);
|
|
28831
|
+
const todayEnd = new Date(todayStart); todayEnd.setDate(todayEnd.getDate() + 1);
|
|
28832
|
+
const events = await outlook.listCalendarView(
|
|
28833
|
+
todayStart.toISOString(),
|
|
28834
|
+
todayEnd.toISOString(),
|
|
28835
|
+
{ orderBy: "start/dateTime", select: ["id", "subject", "start", "end", "attendees"] },
|
|
28836
|
+
);
|
|
28837
|
+
events.value.forEach(e => console.log(e.start.dateTime, e.subject));
|
|
28838
|
+
\`\`\``
|
|
28839
|
+
},
|
|
28840
|
+
tools: tools82,
|
|
28841
|
+
async checkConnection(_params, config) {
|
|
28842
|
+
const { proxyFetch } = config;
|
|
28843
|
+
const url = "https://graph.microsoft.com/v1.0/me";
|
|
28844
|
+
try {
|
|
28845
|
+
const res = await proxyFetch(url, { method: "GET" });
|
|
28846
|
+
if (!res.ok) {
|
|
28847
|
+
const errorText = await res.text().catch(() => res.statusText);
|
|
28848
|
+
return {
|
|
28849
|
+
success: false,
|
|
28850
|
+
error: `Microsoft Graph failed: HTTP ${res.status} ${errorText}`
|
|
28851
|
+
};
|
|
28852
|
+
}
|
|
28853
|
+
return { success: true };
|
|
28854
|
+
} catch (error) {
|
|
28855
|
+
return {
|
|
28856
|
+
success: false,
|
|
28857
|
+
error: error instanceof Error ? error.message : String(error)
|
|
28858
|
+
};
|
|
28859
|
+
}
|
|
28860
|
+
}
|
|
28861
|
+
});
|
|
28862
|
+
|
|
27628
28863
|
// ../connectors/src/connectors/registry.ts
|
|
27629
28864
|
var plugins = {
|
|
27630
28865
|
snowflake: snowflakeConnector,
|
|
@@ -27705,7 +28940,10 @@ var plugins = {
|
|
|
27705
28940
|
freshservice: freshserviceConnector,
|
|
27706
28941
|
freshdesk: freshdeskConnector,
|
|
27707
28942
|
freshsales: freshsalesConnector,
|
|
27708
|
-
github: githubConnector
|
|
28943
|
+
github: githubConnector,
|
|
28944
|
+
powerbiOauth: powerbiOauthConnector,
|
|
28945
|
+
tableau: tableauConnector,
|
|
28946
|
+
outlookOauth: outlookOauthConnector
|
|
27709
28947
|
};
|
|
27710
28948
|
var connectors = {
|
|
27711
28949
|
...plugins,
|
|
@@ -27932,62 +29170,62 @@ import { watch as fsWatch2 } from "fs";
|
|
|
27932
29170
|
import path2 from "path";
|
|
27933
29171
|
|
|
27934
29172
|
// src/types/server-logic.ts
|
|
27935
|
-
import { z as
|
|
27936
|
-
var parameterMetaSchema =
|
|
27937
|
-
name:
|
|
27938
|
-
type:
|
|
27939
|
-
description:
|
|
27940
|
-
required:
|
|
27941
|
-
default:
|
|
27942
|
-
});
|
|
27943
|
-
var serverLogicCacheConfigSchema =
|
|
27944
|
-
ttl:
|
|
27945
|
-
staleWhileRevalidate:
|
|
27946
|
-
});
|
|
27947
|
-
var serverLogicSchemaObjectSchema =
|
|
27948
|
-
() =>
|
|
27949
|
-
type:
|
|
27950
|
-
format:
|
|
27951
|
-
description:
|
|
27952
|
-
nullable:
|
|
27953
|
-
enum:
|
|
29173
|
+
import { z as z100 } from "zod";
|
|
29174
|
+
var parameterMetaSchema = z100.object({
|
|
29175
|
+
name: z100.string(),
|
|
29176
|
+
type: z100.enum(["string", "number", "boolean"]),
|
|
29177
|
+
description: z100.string(),
|
|
29178
|
+
required: z100.boolean().optional(),
|
|
29179
|
+
default: z100.union([z100.string(), z100.number(), z100.boolean()]).optional()
|
|
29180
|
+
});
|
|
29181
|
+
var serverLogicCacheConfigSchema = z100.object({
|
|
29182
|
+
ttl: z100.number(),
|
|
29183
|
+
staleWhileRevalidate: z100.boolean().optional()
|
|
29184
|
+
});
|
|
29185
|
+
var serverLogicSchemaObjectSchema = z100.lazy(
|
|
29186
|
+
() => z100.object({
|
|
29187
|
+
type: z100.enum(["string", "number", "integer", "boolean", "object", "array", "null"]).optional(),
|
|
29188
|
+
format: z100.string().optional(),
|
|
29189
|
+
description: z100.string().optional(),
|
|
29190
|
+
nullable: z100.boolean().optional(),
|
|
29191
|
+
enum: z100.array(z100.union([z100.string(), z100.number(), z100.boolean(), z100.null()])).optional(),
|
|
27954
29192
|
items: serverLogicSchemaObjectSchema.optional(),
|
|
27955
|
-
properties:
|
|
27956
|
-
required:
|
|
27957
|
-
additionalProperties:
|
|
27958
|
-
minimum:
|
|
27959
|
-
maximum:
|
|
27960
|
-
minLength:
|
|
27961
|
-
maxLength:
|
|
27962
|
-
pattern:
|
|
29193
|
+
properties: z100.record(z100.string(), serverLogicSchemaObjectSchema).optional(),
|
|
29194
|
+
required: z100.array(z100.string()).optional(),
|
|
29195
|
+
additionalProperties: z100.union([z100.boolean(), serverLogicSchemaObjectSchema]).optional(),
|
|
29196
|
+
minimum: z100.number().optional(),
|
|
29197
|
+
maximum: z100.number().optional(),
|
|
29198
|
+
minLength: z100.number().optional(),
|
|
29199
|
+
maxLength: z100.number().optional(),
|
|
29200
|
+
pattern: z100.string().optional()
|
|
27963
29201
|
})
|
|
27964
29202
|
);
|
|
27965
|
-
var serverLogicMediaTypeSchema =
|
|
29203
|
+
var serverLogicMediaTypeSchema = z100.object({
|
|
27966
29204
|
schema: serverLogicSchemaObjectSchema.optional(),
|
|
27967
|
-
example:
|
|
29205
|
+
example: z100.unknown().optional()
|
|
27968
29206
|
});
|
|
27969
|
-
var serverLogicResponseSchema =
|
|
27970
|
-
description:
|
|
27971
|
-
content:
|
|
29207
|
+
var serverLogicResponseSchema = z100.object({
|
|
29208
|
+
description: z100.string().optional(),
|
|
29209
|
+
content: z100.record(z100.string(), serverLogicMediaTypeSchema).optional()
|
|
27972
29210
|
});
|
|
27973
29211
|
var jsonBaseFields = {
|
|
27974
|
-
description:
|
|
27975
|
-
parameters:
|
|
29212
|
+
description: z100.string(),
|
|
29213
|
+
parameters: z100.array(parameterMetaSchema).optional(),
|
|
27976
29214
|
response: serverLogicResponseSchema.optional(),
|
|
27977
29215
|
cache: serverLogicCacheConfigSchema.optional()
|
|
27978
29216
|
};
|
|
27979
|
-
var jsonSqlServerLogicSchema =
|
|
29217
|
+
var jsonSqlServerLogicSchema = z100.object({
|
|
27980
29218
|
...jsonBaseFields,
|
|
27981
|
-
type:
|
|
27982
|
-
query:
|
|
27983
|
-
connectionId:
|
|
29219
|
+
type: z100.literal("sql").optional(),
|
|
29220
|
+
query: z100.string(),
|
|
29221
|
+
connectionId: z100.string()
|
|
27984
29222
|
});
|
|
27985
|
-
var jsonTypeScriptServerLogicSchema =
|
|
29223
|
+
var jsonTypeScriptServerLogicSchema = z100.object({
|
|
27986
29224
|
...jsonBaseFields,
|
|
27987
|
-
type:
|
|
27988
|
-
handlerPath:
|
|
29225
|
+
type: z100.literal("typescript"),
|
|
29226
|
+
handlerPath: z100.string()
|
|
27989
29227
|
});
|
|
27990
|
-
var anyJsonServerLogicSchema =
|
|
29228
|
+
var anyJsonServerLogicSchema = z100.union([
|
|
27991
29229
|
jsonTypeScriptServerLogicSchema,
|
|
27992
29230
|
jsonSqlServerLogicSchema
|
|
27993
29231
|
]);
|