@squadbase/vite-server 0.1.12-dev.93b8799 → 0.1.17-dev.24af54e

package/dist/connectors/zendesk.js

@@ -1,48 +1,60 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+
 // ../connectors/src/parameter-definition.ts
-var ParameterDefinition = class {
-  slug;
-  name;
-  description;
-  envVarBaseKey;
-  type;
-  secret;
-  required;
-  constructor(config) {
-    this.slug = config.slug;
-    this.name = config.name;
-    this.description = config.description;
-    this.envVarBaseKey = config.envVarBaseKey;
-    this.type = config.type;
-    this.secret = config.secret;
-    this.required = config.required;
-  }
-  /**
-   * Get the parameter value from a ConnectorConnectionObject.
-   */
-  getValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) {
-      throw new Error(
-        `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
-      );
-    }
-    return param.value;
-  }
-  /**
-   * Try to get the parameter value. Returns undefined if not found (for optional params).
-   */
-  tryGetValue(connection2) {
-    const param = connection2.parameters.find(
-      (p) => p.parameterSlug === this.slug
-    );
-    if (!param || param.value == null) return void 0;
-    return param.value;
+var ParameterDefinition;
+var init_parameter_definition = __esm({
+  "../connectors/src/parameter-definition.ts"() {
+    "use strict";
+    ParameterDefinition = class {
+      slug;
+      name;
+      description;
+      envVarBaseKey;
+      type;
+      secret;
+      required;
+      constructor(config) {
+        this.slug = config.slug;
+        this.name = config.name;
+        this.description = config.description;
+        this.envVarBaseKey = config.envVarBaseKey;
+        this.type = config.type;
+        this.secret = config.secret;
+        this.required = config.required;
+      }
+      /**
+       * Get the parameter value from a ConnectorConnectionObject.
+       */
+      getValue(connection2) {
+        const param = connection2.parameters.find(
+          (p) => p.parameterSlug === this.slug
+        );
+        if (!param || param.value == null) {
+          throw new Error(
+            `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
+          );
+        }
+        return param.value;
+      }
+      /**
+       * Try to get the parameter value. Returns undefined if not found (for optional params).
+       */
+      tryGetValue(connection2) {
+        const param = connection2.parameters.find(
+          (p) => p.parameterSlug === this.slug
+        );
+        if (!param || param.value == null) return void 0;
+        return param.value;
+      }
+    };
   }
-};
+});
 
 // ../connectors/src/connectors/zendesk/parameters.ts
+init_parameter_definition();
 var parameters = {
   subdomain: new ParameterDefinition({
     slug: "subdomain",
@@ -248,6 +260,20 @@ var ConnectorPlugin = class _ConnectorPlugin {
    * `runSetupFlow` from `setup-flow.ts`.
    */
   setup;
+  /**
+   * Opt-out of the default "verify before save" behavior on connection
+   * creation. The backend invokes `checkConnection` synchronously while
+   * creating the connection and aborts (no row inserted) if it fails — this
+   * flag disables that for connectors where the check cannot succeed pre-save:
+   *
+   *   - `squadbase-db` populates `connection-url` only after Neon provisioning
+   *   - OAuth connectors require an OAuth-aware proxyFetch keyed by the
+   *     connectionId, which doesn't exist until the row is saved
+   *
+   * Exceptions are the explicit position; new credential-input connectors get
+   * the default verify-on-create behavior without opt-in.
+   */
+  skipConnectionCheckOnCreate;
   constructor(config) {
     this.slug = config.slug;
     this.authType = config.authType;
@@ -265,6 +291,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     this.query = config.query;
     this.checkConnection = config.checkConnection;
     this.setup = config.setup;
+    this.skipConnectionCheckOnCreate = config.skipConnectionCheckOnCreate;
   }
   get connectorKey() {
     return _ConnectorPlugin.deriveKey(this.slug, this.authType);
@@ -329,6 +356,51 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/setup-flow.ts
+async function runSetupFlow(flow, params, ctx, config) {
+  const runtime = {
+    params,
+    language: ctx.language,
+    config
+  };
+  let state = flow.initialState();
+  let answerIdx = 0;
+  for (const step of flow.steps) {
+    const ans = ctx.answers[answerIdx];
+    if (ans && ans.questionSlug === step.slug) {
+      state = step.applyAnswer(state, ans.answer);
+      answerIdx += 1;
+      continue;
+    }
+    if (step.type === "text") {
+      return {
+        type: "nextQuestion",
+        questionSlug: step.slug,
+        question: step.question[ctx.language],
+        questionType: "text"
+      };
+    }
+    const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
+    if (options.length === 0) {
+      continue;
+    }
+    return {
+      type: "nextQuestion",
+      questionSlug: step.slug,
+      question: step.question[ctx.language],
+      questionType: step.type,
+      options
+    };
+  }
+  const dataInvestigationResult = await flow.finalize(state, runtime);
+  return { type: "fulfilled", dataInvestigationResult };
+}
+async function resolveSetupSelection(params) {
+  const { selected, allSentinel, fetchAll, limit } = params;
+  const resolved = selected.includes(allSentinel) ? await fetchAll() : selected.filter((v) => v !== allSentinel);
+  return resolved.slice(0, limit);
+}
+
 // ../connectors/src/auth-types.ts
 var AUTH_TYPES = {
   OAUTH: "oauth",
@@ -353,6 +425,150 @@ var zendeskOnboarding = new ConnectorOnboarding({
   }
 });
 
+// ../connectors/src/connectors/zendesk/utils.ts
+function normalizeSubdomain(raw) {
+  return raw.trim().replace(/^https?:\/\//i, "").replace(/\.zendesk\.com.*$/, "").replace(/\/+$/, "").split(".")[0];
+}
+function basicAuthHeader(email, apiToken) {
+  return `Basic ${Buffer.from(`${email}/token:${apiToken}`).toString("base64")}`;
+}
+async function apiFetch(params, path2, init) {
+  const subdomain = params[parameters.subdomain.slug];
+  const email = params[parameters.email.slug];
+  const apiToken = params[parameters.apiToken.slug];
+  if (!subdomain || !email || !apiToken) {
+    throw new Error(
+      "zendesk: missing required parameter(s) (subdomain, email, api-token)"
+    );
+  }
+  const url = `https://${normalizeSubdomain(subdomain)}.zendesk.com${path2.startsWith("/") ? "" : "/"}${path2}`;
+  const headers = new Headers(init?.headers);
+  headers.set("Authorization", basicAuthHeader(email, apiToken));
+  headers.set("Accept", "application/json");
+  return fetch(url, { ...init, headers });
+}
+
+// ../connectors/src/connectors/zendesk/setup-flow.ts
+var ZENDESK_SETUP_MAX_ENTITIES = 5;
+var ZENDESK_ENTITIES = [
+  {
+    value: "tickets",
+    label: "Tickets",
+    countPath: "/api/v2/tickets.json?page[size]=1",
+    countField: "count"
+  },
+  {
+    value: "users",
+    label: "Users",
+    countPath: "/api/v2/users.json?page[size]=1",
+    countField: "count"
+  },
+  {
+    value: "organizations",
+    label: "Organizations",
+    countPath: "/api/v2/organizations.json?page[size]=1",
+    countField: "count"
+  },
+  {
+    value: "groups",
+    label: "Groups",
+    countPath: "/api/v2/groups.json?page[size]=1",
+    countField: "count"
+  },
+  {
+    value: "articles",
+    label: "Help Center articles",
+    countPath: "/api/v2/help_center/articles.json?page[size]=1",
+    countField: "count"
+  }
+];
+async function listBrands(params) {
+  const res = await apiFetch(params, "/api/v2/brands.json");
+  if (!res.ok) return [];
+  const data = await res.json();
+  return data.brands ?? [];
+}
+async function fetchCount(params, path2, countField) {
+  const res = await apiFetch(params, path2);
+  if (!res.ok) return null;
+  const data = await res.json();
+  const raw = data[countField];
+  if (typeof raw === "number") return raw;
+  if (typeof data["count"] === "number") return data["count"];
+  return null;
+}
+var zendeskSetupFlow = {
+  initialState: () => ({}),
+  steps: [
+    {
+      slug: "brand",
+      type: "select",
+      question: {
+        ja: "\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3067\u5BFE\u8C61\u3068\u3059\u308BZendesk\u30D6\u30E9\u30F3\u30C9\u3092\u9078\u3093\u3067\u304F\u3060\u3055\u3044",
+        en: "Select the Zendesk brand to use for setup"
+      },
+      async fetchOptions(_state, rt) {
+        const brands = await listBrands(rt.params);
+        const active = brands.filter((b) => b.active !== false && b.name);
+        if (active.length < 2) return [];
+        return active.map((b) => ({
+          value: String(b.subdomain ?? b.id ?? b.name),
+          label: String(b.name)
+        }));
+      },
+      applyAnswer: (state, answer) => ({ ...state, brand: answer[0] })
+    },
+    {
+      slug: "entities",
+      type: "multiSelect",
+      question: {
+        ja: "\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3067\u6982\u89B3\u3057\u305F\u3044\u30A8\u30F3\u30C6\u30A3\u30C6\u30A3\u3092\u9078\u3093\u3067\u304F\u3060\u3055\u3044\uFF08\u8907\u6570\u9078\u629E\u53EF\uFF09",
+        en: "Select the entities to include in setup (multi-select allowed)"
+      },
+      async fetchOptions(_state, _rt) {
+        return ZENDESK_ENTITIES.map((e) => ({ value: e.value, label: e.label }));
+      },
+      applyAnswer: (state, answer) => ({ ...state, entities: answer })
+    }
+  ],
+  async finalize(state, rt) {
+    if (!state.entities) {
+      throw new Error("Zendesk setup: incomplete state on finalize");
+    }
+    const targetEntities = await resolveSetupSelection({
+      selected: state.entities,
+      allSentinel: "__ALL__",
+      fetchAll: async () => ZENDESK_ENTITIES.map((e) => e.value),
+      limit: ZENDESK_SETUP_MAX_ENTITIES
+    });
+    const entityByValue = new Map(ZENDESK_ENTITIES.map((e) => [e.value, e]));
+    const sections = ["## Zendesk", ""];
+    if (state.brand) {
+      sections.push(`### Brand: ${state.brand}`, "");
+    }
+    sections.push("### Selected entities", "");
+    sections.push("| Entity | Count |");
+    sections.push("|--------|-------|");
+    for (const value of targetEntities) {
+      const entity = entityByValue.get(value);
+      if (!entity) {
+        sections.push(`| ${value} | _unknown_ |`);
+        continue;
+      }
+      const count = await fetchCount(
+        rt.params,
+        entity.countPath,
+        entity.countField
+      );
+      sections.push(
+        `| ${entity.label} (${entity.value}) | ${count == null ? "-" : count} |`
+      );
+    }
+    sections.push("");
+    return sections.join("\n");
+  }
+};
+
 // ../connectors/src/connectors/zendesk/tools/request.ts
 import { z } from "zod";
 var REQUEST_TIMEOUT_MS = 6e4;
@@ -621,7 +837,48 @@ export default async function handler(c: Context) {
 - \`type:user role:agent\` \u2014 \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u30E6\u30FC\u30B6\u30FC
 - \`type:organization {name}\` \u2014 \u540D\u524D\u304C\u4E00\u81F4\u3059\u308B\u7D44\u7E54`
   },
-  tools
+  tools,
+  setup: (params, ctx, config) => runSetupFlow(zendeskSetupFlow, params, ctx, config),
+  async checkConnection(params, _config) {
+    const subdomain = params[parameters.subdomain.slug];
+    const email = params[parameters.email.slug];
+    const apiToken = params[parameters.apiToken.slug];
+    if (!subdomain || !email || !apiToken) {
+      return {
+        success: false,
+        error: `Missing required parameter(s): ${parameters.subdomain.slug}, ${parameters.email.slug}, ${parameters.apiToken.slug}`
+      };
+    }
+    try {
+      const credentials = Buffer.from(
+        `${email}/token:${apiToken}`,
+        "utf-8"
+      ).toString("base64");
+      const res = await fetch(
+        `https://${subdomain}.zendesk.com/api/v2/users/me.json`,
+        {
+          method: "GET",
+          headers: {
+            Authorization: `Basic ${credentials}`,
+            Accept: "application/json"
+          }
+        }
+      );
+      if (!res.ok) {
+        const errText = await res.text().catch(() => res.statusText);
+        return {
+          success: false,
+          error: `Zendesk API failed: HTTP ${res.status} ${errText}`
+        };
+      }
+      return { success: true };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
 });
 
 // src/connectors/create-connector-sdk.ts
@@ -650,6 +907,7 @@ function resolveEnvVarOptional(entry, key) {
 import { getContext } from "hono/context-storage";
 import { getCookie } from "hono/cookie";
 var APP_SESSION_COOKIE_NAME = "__Host-squadbase-session";
+var TABLEAU_SESSION_SENTINEL_URL = "squadbase://tableau-session/";
 function normalizeHeaders(input) {
   const out = {};
   if (!input) return out;
@@ -658,6 +916,11 @@ function normalizeHeaders(input) {
   });
   return out;
 }
+function extractInputUrl(input) {
+  if (typeof input === "string") return input;
+  if (input instanceof URL) return input.href;
+  return input.url;
+}
 function createSandboxProxyFetch(connectionId) {
   return async (input, init) => {
     const token = process.env.INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL;
@@ -667,10 +930,17 @@ function createSandboxProxyFetch(connectionId) {
         "Connection proxy is not configured. Please check your deployment settings."
       );
     }
-    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalUrl = extractInputUrl(input);
+    const baseDomain = process.env["SQUADBASE_PREVIEW_BASE_DOMAIN"] ?? "preview.app.squadbase.dev";
+    if (originalUrl === TABLEAU_SESSION_SENTINEL_URL) {
+      const sessionUrl = `https://${sandboxId}.${baseDomain}/_sqcore/connections/${connectionId}/tableau-session`;
+      return fetch(sessionUrl, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${token}` }
+      });
+    }
     const originalMethod = init?.method ?? "GET";
     const originalBody = init?.body ? JSON.parse(init.body) : void 0;
-    const baseDomain = process.env["SQUADBASE_PREVIEW_BASE_DOMAIN"] ?? "preview.app.squadbase.dev";
     const proxyUrl = `https://${sandboxId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
     return fetch(proxyUrl, {
       method: "POST",
@@ -696,10 +966,9 @@ function createDeployedAppProxyFetch(connectionId) {
   }
   const baseDomain = process.env["SQUADBASE_APP_BASE_DOMAIN"] ?? "squadbase.app";
   const proxyUrl = `https://${projectId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+  const sessionUrl = `https://${projectId}.${baseDomain}/_sqcore/connections/${connectionId}/tableau-session`;
   return async (input, init) => {
-    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
-    const originalMethod = init?.method ?? "GET";
-    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const originalUrl = extractInputUrl(input);
     const c = getContext();
     const appSession = getCookie(c, APP_SESSION_COOKIE_NAME);
     if (!appSession) {
@@ -707,6 +976,14 @@ function createDeployedAppProxyFetch(connectionId) {
         "No authentication method available for connection proxy."
       );
     }
+    if (originalUrl === TABLEAU_SESSION_SENTINEL_URL) {
+      return fetch(sessionUrl, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${appSession}` }
+      });
+    }
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
     return fetch(proxyUrl, {
       method: "POST",
       headers: {

package/dist/index.d.ts

@@ -132,6 +132,154 @@ declare function connection(connectionId: string): {
     fetch(url: string, options?: ConnectionFetchOptions): Promise<Response>;
 };
 
+/**
+ * Project Storage (SQPD-1213) — HTTP transport for `@squadbase/vite-server`。
+ *
+ * 設計は `connector-client/proxy-fetch.ts` (IP allowlist 越えのコネクション proxy) と同じ
+ * 2 経路パターン。両経路とも user-function-proxy の `/_sqcore/storage/*` を叩く。
+ *
+ * - **Sandbox 内 vite-server (preview-app server-side / ユーザーアプリ server-side)**:
+ *   URL = `https://${INTERNAL_SQUADBASE_SANDBOX_ID}.${SQUADBASE_PREVIEW_BASE_DOMAIN}/_sqcore/storage/*`
+ *   認証 = `Authorization: Bearer ${INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL}`
+ *   default base domain: `preview.app.squadbase.dev`
+ *
+ * - **デプロイ済みアプリ**:
+ *   URL = `https://${SQUADBASE_PROJECT_ID}.${SQUADBASE_APP_BASE_DOMAIN}/_sqcore/storage/*`
+ *   認証 = `__Host-squadbase-session` cookie を `Authorization: Bearer` に転送
+ *   default base domain: `squadbase.app`
+ *
+ * 経路判定は `INTERNAL_SQUADBASE_SANDBOX_ID` の有無で行う。
+ * Coding-Agent から呼ぶ app-api 直経路は本 SDK では持たず、coding-agent 側で別実装する。
+ */
+type PresignedPutResult = {
+    url: string;
+    headers: Record<string, string>;
+    expiresAt: string;
+};
+type PresignedGetResult = {
+    url: string;
+    expiresAt: string;
+};
+type StorageMetadata = {
+    key: string;
+    size: number;
+    contentType: string;
+    createdAt: string;
+    createdBy: string;
+    source: "upload" | "agent" | "system";
+};
+type StorageListItem = {
+    key: string;
+    size: number;
+    lastModified: string;
+};
+type StorageListResult = {
+    objects: StorageListItem[];
+    nextCursor?: string;
+};
+type StorageUsageDelta = {
+    totalSizeBytes: number;
+    objectCount: number;
+};
+interface StorageTransport {
+    signPut(relativeKey: string, contentType: string, contentLength: number): Promise<PresignedPutResult>;
+    signGet(relativeKey: string): Promise<PresignedGetResult>;
+    notifyUploaded(relativeKey: string, size: number): Promise<StorageUsageDelta>;
+    list(prefix?: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<StorageListResult>;
+    head(relativeKey: string): Promise<StorageMetadata>;
+    delete(relativeKey: string): Promise<StorageUsageDelta>;
+    copy(srcRelativeKey: string, destRelativeKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+    move(srcRelativeKey: string, destRelativeKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+}
+declare class PresignedHttpsTransport implements StorageTransport {
+    signPut(key: string, contentType: string, contentLength: number): Promise<PresignedPutResult>;
+    signGet(key: string): Promise<PresignedGetResult>;
+    notifyUploaded(key: string, size: number): Promise<StorageUsageDelta>;
+    list(prefix?: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<StorageListResult>;
+    head(key: string): Promise<StorageMetadata>;
+    delete(key: string): Promise<StorageUsageDelta>;
+    copy(srcKey: string, destKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+    move(srcKey: string, destKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+}
+
+/**
+ * Project Storage (SQPD-1213) — `storage.uploads.*` の SDK 実装。
+ *
+ * 二段ネスト命名 (`storage.uploads.*`) で `agent` / `system` 名前空間の将来追加に備える。
+ * slice1+2 (put/get/head/list/delete/uploaded callback) を提供し、copy/move は slice3 で追加。
+ */
+
+type PutOptions = {
+    contentType?: string;
+};
+type ListOptions = {
+    limit?: number;
+    cursor?: string;
+};
+type GetResult = {
+    /** S3 から取得した body。Hono / Node fetch の Response.body 互換 (ReadableStream<Uint8Array> | null)。 */
+    body: ReadableStream<Uint8Array> | null;
+    /** head 相当のメタデータ */
+    metadata: StorageMetadata;
+};
+declare class StorageUploadsClient {
+    private readonly transport;
+    constructor(transport: StorageTransport);
+    put(key: string, data: Buffer | Uint8Array | ArrayBuffer | Blob, options?: PutOptions): Promise<StorageUsageDelta>;
+    get(key: string): Promise<GetResult>;
+    head(key: string): Promise<StorageMetadata>;
+    list(prefix?: string, options?: ListOptions): Promise<StorageListResult>;
+    delete(key: string): Promise<StorageUsageDelta>;
+    copy(srcKey: string, destKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+    /**
+     * rename も本メソッドで表現する (内部的には copy + src 削除を backend で実施)。
+     */
+    move(srcKey: string, destKey: string, options?: {
+        overwrite?: boolean;
+    }): Promise<StorageUsageDelta>;
+}
+
+/**
+ * Project Storage (SQPD-1213) — public SDK entry。
+ *
+ * ユーザーアプリ (vite-server で動くサーバーロジック) から以下のように利用する:
+ *
+ * ```ts
+ * import { storage } from "@squadbase/vite-server";
+ *
+ * await storage.uploads.put("reports/2026-05.csv", buffer, { contentType: "text/csv" });
+ * const { body, metadata } = await storage.uploads.get("reports/2026-05.csv");
+ * const { objects, nextCursor } = await storage.uploads.list("reports/");
+ * ```
+ *
+ * `agent` / `system` 名前空間は将来追加 (現在は uploads のみ)。
+ */
+
+/**
+ * Project Storage の SDK 入口。
+ *
+ * 現状は `uploads` のみ。将来 `agent` / `system` を追加するときも公開 API を破壊しない。
+ */
+declare const storage: {
+    uploads: StorageUploadsClient;
+};
+
 declare const app: Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
 
-export { type AirtableClient, type AirtableRecord, type ConnectionEntry, type ConnectionFetchOptions, type ConnectionsMap, type DbtClient, type GoogleAnalyticsClient, type KintoneClient, type QueryFn, type WixStoreClient, connection, createAirtableClient, createDbtClient, createGoogleAnalyticsClient, createKintoneClient, createWixStoreClient, app as default, getQuery, loadConnections };
+export { type AirtableClient, type AirtableRecord, type ConnectionEntry, type ConnectionFetchOptions, type ConnectionsMap, type DbtClient, type GoogleAnalyticsClient, type KintoneClient, type PresignedGetResult, PresignedHttpsTransport, type PresignedPutResult, type QueryFn, type GetResult as StorageGetResult, type StorageListItem, type ListOptions as StorageListOptions, type StorageListResult, type StorageMetadata, type PutOptions as StoragePutOptions, type StorageTransport, StorageUploadsClient, type StorageUsageDelta, type WixStoreClient, connection, createAirtableClient, createDbtClient, createGoogleAnalyticsClient, createKintoneClient, createWixStoreClient, app as default, getQuery, loadConnections, storage };