@tool-bridge/server 0.1.1 → 0.3.0

package/dist/turso-FW56U2B3.js

@@ -0,0 +1,432 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/turso/api.ts
+var SERVICE = "turso";
+var API_BASE = "https://api.turso.tech";
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} is required.`);
+  return result;
+}
+function compact(input) {
+  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
+}
+function responseError(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function normalizeResource(raw) {
+  return compact({
+    slug: text(raw.slug),
+    name: text(raw.name),
+    type: text(raw.type),
+    location: text(raw.location),
+    uuid: text(raw.uuid),
+    group: text(raw.group),
+    hostname: text(raw.hostname),
+    code: text(raw.code),
+    raw
+  });
+}
+function normalizeItems(items) {
+  return items.flatMap((item) => {
+    const fields = record(item);
+    return fields === void 0 ? [] : [normalizeResource(fields)];
+  });
+}
+function resourceList(payload, keys) {
+  if (Array.isArray(payload)) return normalizeItems(payload);
+  const fields = record(payload);
+  if (fields === void 0) throw responseError("Turso returned an invalid list response");
+  for (const key of [...keys, "data"]) {
+    const value = fields[key];
+    if (Array.isArray(value)) return normalizeItems(value);
+  }
+  throw responseError("Turso list response is missing items");
+}
+function singleResource(payload, keys) {
+  const fields = record(payload);
+  if (fields === void 0) throw responseError("Turso returned an invalid resource response");
+  for (const key of [...keys, "data"]) {
+    const value = record(fields[key]);
+    if (value !== void 0) return normalizeResource(value);
+  }
+  return normalizeResource(fields);
+}
+function readPayload(body) {
+  if (body.trim() === "") return {};
+  try {
+    return JSON.parse(body);
+  } catch {
+    return { message: body };
+  }
+}
+function errorMessage(payload, status) {
+  const direct = text(payload);
+  if (direct !== void 0) return direct;
+  const fields = record(payload);
+  const nested = record(fields?.error);
+  const message = text(fields?.message) ?? text(fields?.error) ?? text(fields?.detail) ?? text(fields?.title) ?? text(nested?.message) ?? text(nested?.detail);
+  return message ?? `Turso request failed with ${status}`;
+}
+async function request(ctx, input) {
+  const apiKey = requireApiKey(ctx, SERVICE);
+  let response;
+  let payload;
+  try {
+    response = await guardedFetch(`${API_BASE}${input.path}`, {
+      method: input.method,
+      headers: {
+        accept: "application/json",
+        authorization: `Bearer ${apiKey}`,
+        ...input.body === void 0 ? {} : { "content-type": "application/json" }
+      },
+      body: input.body === void 0 ? void 0 : JSON.stringify(input.body)
+    });
+    payload = readPayload(await response.text());
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    throw upstreamError(502, error instanceof Error ? `Turso request failed: ${error.message}` : "Turso request failed");
+  }
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload, response.status));
+  return payload;
+}
+function organizationPath(organizationSlug) {
+  return `/v1/organizations/${encodeURIComponent(requireText(organizationSlug, "organizationSlug"))}`;
+}
+function extensions(value) {
+  if (value === void 0 || value === "all") return value;
+  return value.map((item) => requireText(item, "extensions"));
+}
+async function listOrganizations(_input, ctx) {
+  const payload = await request(ctx, { method: "GET", path: "/v1/organizations" });
+  return { organizations: resourceList(payload, ["organizations"]) };
+}
+async function getOrganization(input, ctx) {
+  const payload = await request(ctx, { method: "GET", path: organizationPath(input.organizationSlug) });
+  return { organization: singleResource(payload, ["organization"]) };
+}
+async function listLocations(_input, ctx) {
+  const payload = await request(ctx, { method: "GET", path: "/v1/locations" });
+  return { locations: resourceList(payload, ["locations", "regions"]) };
+}
+async function listGroups(input, ctx) {
+  const payload = await request(ctx, { method: "GET", path: `${organizationPath(input.organizationSlug)}/groups` });
+  return { groups: resourceList(payload, ["groups"]) };
+}
+async function getGroup(input, ctx) {
+  const name = encodeURIComponent(requireText(input.name, "name"));
+  const payload = await request(ctx, {
+    method: "GET",
+    path: `${organizationPath(input.organizationSlug)}/groups/${name}`
+  });
+  return { group: singleResource(payload, ["group"]) };
+}
+async function createGroup(input, ctx) {
+  const payload = await request(ctx, {
+    method: "POST",
+    path: `${organizationPath(input.organizationSlug)}/groups`,
+    body: compact({
+      name: requireText(input.name, "name"),
+      location: requireText(input.location, "location"),
+      extensions: extensions(input.extensions)
+    })
+  });
+  return { group: singleResource(payload, ["group"]) };
+}
+async function listDatabases(input, ctx) {
+  const payload = await request(ctx, { method: "GET", path: `${organizationPath(input.organizationSlug)}/databases` });
+  return { databases: resourceList(payload, ["databases"]) };
+}
+async function getDatabase(input, ctx) {
+  const name = encodeURIComponent(requireText(input.name, "name"));
+  const payload = await request(ctx, {
+    method: "GET",
+    path: `${organizationPath(input.organizationSlug)}/databases/${name}`
+  });
+  return { database: singleResource(payload, ["database"]) };
+}
+async function createDatabase(input, ctx) {
+  const payload = await request(ctx, {
+    method: "POST",
+    path: `${organizationPath(input.organizationSlug)}/databases`,
+    // 上游这里没走 compactObject:两个字段都是必填,给不出就该在断言处炸。
+    body: {
+      name: requireText(input.name, "name"),
+      group: requireText(input.group, "group")
+    }
+  });
+  return { database: singleResource(payload, ["database"]) };
+}
+async function deleteDatabase(input, ctx) {
+  const name = encodeURIComponent(requireText(input.name, "name"));
+  await request(ctx, {
+    method: "DELETE",
+    path: `${organizationPath(input.organizationSlug)}/databases/${name}`
+  });
+  return { deleted: true };
+}
+
+// ../plugins/src/turso/schema.ts
+var listOrganizationsInput = external_exports.strictObject({}).describe("The input payload for listing Turso organizations.");
+var listOrganizationsOutput = external_exports.strictObject({
+  organizations: external_exports.array(external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")).describe("The organizations visible to the current API token.")
+}).describe("The organizations returned by the Turso Platform API.");
+var getOrganizationInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path.")
+}).describe("The input payload for retrieving one organization.");
+var getOrganizationOutput = external_exports.strictObject({
+  organization: external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")
+}).describe("The organization returned by the Turso Platform API.");
+var listLocationsInput = external_exports.strictObject({}).describe("The input payload for listing Turso locations.");
+var listLocationsOutput = external_exports.strictObject({
+  locations: external_exports.array(external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")).describe("The available Turso locations.")
+}).describe("The locations returned by the Turso Platform API.");
+var listGroupsInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path.")
+}).describe("The input payload for listing Turso groups.");
+var listGroupsOutput = external_exports.strictObject({
+  groups: external_exports.array(external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")).describe("The Turso groups belonging to the organization.")
+}).describe("The Turso groups returned for one organization.");
+var getGroupInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path."),
+  name: external_exports.string().min(1).describe("The Turso group name.")
+}).describe("The input payload for retrieving one Turso group.");
+var getGroupOutput = external_exports.strictObject({
+  group: external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")
+}).describe("The Turso group returned by the Platform API.");
+var createGroupInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path."),
+  name: external_exports.string().min(1).describe("The Turso group name."),
+  location: external_exports.string().min(1).describe("The primary Turso location code for the group."),
+  extensions: external_exports.union([external_exports.enum(["all"]).describe("Enable every supported extension."), external_exports.array(external_exports.string().min(1).describe("One Turso extension name.")).min(1).describe("The explicit extension names to enable for new databases in the group.")]).describe("The extensions to enable for new databases in the group.").optional()
+}).describe("The input payload for creating a Turso group.");
+var createGroupOutput = external_exports.strictObject({
+  group: external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")
+}).describe("The newly created Turso group.");
+var listDatabasesInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path.")
+}).describe("The input payload for listing Turso databases.");
+var listDatabasesOutput = external_exports.strictObject({
+  databases: external_exports.array(external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")).describe("The Turso databases belonging to the organization.")
+}).describe("The Turso databases returned for one organization.");
+var getDatabaseInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path."),
+  name: external_exports.string().min(1).describe("The Turso database name.")
+}).describe("The input payload for retrieving one Turso database.");
+var getDatabaseOutput = external_exports.strictObject({
+  database: external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")
+}).describe("The Turso database returned by the Platform API.");
+var createDatabaseInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path."),
+  name: external_exports.string().min(1).describe("The Turso database name."),
+  group: external_exports.string().min(1).describe("The Turso group where the database should be created.")
+}).describe("The input payload for creating a Turso database.");
+var createDatabaseOutput = external_exports.strictObject({
+  database: external_exports.strictObject({
+    slug: external_exports.string().min(1).describe("The resource slug when Turso returns one.").optional(),
+    name: external_exports.string().min(1).describe("The resource name when Turso returns one.").optional(),
+    type: external_exports.string().min(1).describe("The resource type when Turso returns one.").optional(),
+    location: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    uuid: external_exports.string().min(1).describe("The UUID when Turso returns one.").optional(),
+    group: external_exports.string().min(1).describe("The group name when Turso returns one.").optional(),
+    hostname: external_exports.string().min(1).describe("The database hostname when Turso returns one.").optional(),
+    code: external_exports.string().min(1).describe("The location code when Turso returns one.").optional(),
+    raw: external_exports.looseObject({}).describe("The raw Turso resource object returned by the Platform API.")
+  }).describe("A normalized Turso Platform API resource.")
+}).describe("The newly created Turso database.");
+var deleteDatabaseInput = external_exports.strictObject({
+  organizationSlug: external_exports.string().min(1).describe("The organization slug used in the Turso API path."),
+  name: external_exports.string().min(1).describe("The Turso database name.")
+}).describe("The input payload for deleting one Turso database.");
+var deleteDatabaseOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether the connector finished the delete request successfully.")
+}).describe("The normalized delete result returned by the connector.");
+var tursoActions = {
+  list_organizations: {
+    description: "List organizations visible to the current Turso Platform API token.",
+    effect: "read",
+    inputSchema: listOrganizationsInput,
+    outputSchema: external_exports.toJSONSchema(listOrganizationsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_organization: {
+    description: "Retrieve one Turso organization by slug.",
+    effect: "read",
+    inputSchema: getOrganizationInput,
+    outputSchema: external_exports.toJSONSchema(getOrganizationOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_locations: {
+    description: "List available Turso locations that can host groups.",
+    effect: "read",
+    inputSchema: listLocationsInput,
+    outputSchema: external_exports.toJSONSchema(listLocationsOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_groups: {
+    description: "List Turso groups for one organization.",
+    effect: "read",
+    inputSchema: listGroupsInput,
+    outputSchema: external_exports.toJSONSchema(listGroupsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_group: {
+    description: "Retrieve one Turso group by name within an organization.",
+    effect: "read",
+    inputSchema: getGroupInput,
+    outputSchema: external_exports.toJSONSchema(getGroupOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_group: {
+    description: "Create a Turso group in one organization with a primary location.",
+    effect: "write",
+    inputSchema: createGroupInput,
+    outputSchema: external_exports.toJSONSchema(createGroupOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_databases: {
+    description: "List Turso databases for one organization.",
+    effect: "read",
+    inputSchema: listDatabasesInput,
+    outputSchema: external_exports.toJSONSchema(listDatabasesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_database: {
+    description: "Retrieve one Turso database by name within an organization.",
+    effect: "read",
+    inputSchema: getDatabaseInput,
+    outputSchema: external_exports.toJSONSchema(getDatabaseOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_database: {
+    description: "Create a Turso database in one organization and group.",
+    effect: "write",
+    inputSchema: createDatabaseInput,
+    outputSchema: external_exports.toJSONSchema(createDatabaseOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_database: {
+    description: "Delete a Turso database from one organization.",
+    effect: "destructive",
+    inputSchema: deleteDatabaseInput,
+    outputSchema: external_exports.toJSONSchema(deleteDatabaseOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/turso/index.ts
+function createTursoPlugin() {
+  return createProviderPlugin({
+    description: "Turso",
+    actions: tursoActions,
+    // 上游 credentialValidators 打的 `/v1/auth/validate` 没有对应 action;`list_organizations`
+    // 同样只读、无必填入参,且同样要求 Platform token 有效,拿它当挂载时的凭证探针。
+    credentialProbe: "list_organizations",
+    handlers: {
+      list_organizations: listOrganizations,
+      get_organization: getOrganization,
+      list_locations: listLocations,
+      list_groups: listGroups,
+      get_group: getGroup,
+      create_group: createGroup,
+      list_databases: listDatabases,
+      get_database: getDatabase,
+      create_database: createDatabase,
+      delete_database: deleteDatabase
+    }
+  });
+}
+var turso_default = createTursoPlugin();
+export {
+  createTursoPlugin,
+  turso_default as default
+};