@squadbase/vite-server 0.1.18 → 0.1.19-dev.40d2ebd

package/dist/index.js

@@ -10547,8 +10547,8 @@ init_parameter_definition();
 var parameters16 = {
   propertyId: new ParameterDefinition({
     slug: "property-id",
-    name: "Google Analytics Property ID",
-    description: "The Google Analytics 4 property ID (e.g., 123456789). Can be found in GA4 Admin > Property Settings.",
+    name: "Default Property ID",
+    description: "Optional default Google Analytics 4 property ID (e.g., 123456789) used when a request does not specify one. Can be found in GA4 Admin > Property Settings. Leave empty to always pass the property ID per request.",
     envVarBaseKey: "GA_OAUTH_PROPERTY_ID",
     type: "text",
     secret: false,
@@ -10861,7 +10861,7 @@ var inputSchema25 = z25.object({
   connectionId: z25.string().describe("ID of the Google Analytics OAuth connection to use"),
   method: z25.enum(["GET", "POST"]).describe("HTTP method"),
   path: z25.string().describe(
-    "API path appended to https://analyticsdata.googleapis.com/v1beta/ (e.g., 'properties/{propertyId}:runReport'). {propertyId} is automatically replaced."
+    "API path appended to https://analyticsdata.googleapis.com/v1beta/ (e.g., 'properties/123456789:runReport'). Write the numeric property id directly; the {propertyId} placeholder is only substituted when a default property is configured on the connection."
   ),
   body: z25.record(z25.string(), z25.unknown()).optional().describe("POST request body (JSON)")
 });
@@ -10880,7 +10880,7 @@ var requestTool4 = new ConnectorTool({
   name: "request",
   description: `Send authenticated requests to the Google Analytics Data API v1beta.
 Authentication is handled automatically via OAuth proxy.
-{propertyId} in the path is automatically replaced with the connection's property ID.`,
+Write the numeric property id directly into the path (e.g. properties/123456789:runReport). The {propertyId} placeholder is only substituted when a default property is configured on the connection.`,
   inputSchema: inputSchema25,
   outputSchema: outputSchema25,
   async execute({ connectionId, method, path: path5, body }, connections, config) {
@@ -10967,7 +10967,7 @@ var googleAnalyticsOauthConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`connector_google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. The {propertyId} placeholder in paths is automatically replaced. Authentication is configured automatically via OAuth.
+- \`connector_google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. Write the target property into the path as \`properties/{numericPropertyId}\` (the \`{propertyId}\` placeholder is only substituted when a default property is configured on the connection). Authentication is configured automatically via OAuth.
 - \`connector_google-analytics-oauth_listAccounts\`: List accessible Google Analytics accounts. Use during setup to discover available accounts.
 - \`connector_google-analytics-oauth_listProperties\`: List GA4 properties for a given account. Use during setup to select the target property.
 
@@ -11003,10 +11003,12 @@ averageSessionDuration, conversions, totalRevenue
 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.
 
 SDK surface (client created via \`connection(connectionId)\`):
-- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (\`path\` is appended to \`https://analyticsdata.googleapis.com/v1beta/\`).
-- \`client.runReport(request)\` \u2014 run a GA4 report.
-- \`client.runRealtimeReport(request)\` \u2014 run a realtime report.
-- \`client.getMetadata()\` \u2014 fetch available dimensions and metrics.
+- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (\`path\` is appended to \`https://analyticsdata.googleapis.com/v1beta/\`; \`{propertyId}\` placeholders are auto-replaced only when a default property is configured on the connection).
+- \`client.runReport(request)\` \u2014 run a GA4 report. Set \`propertyId\` (bare numeric id) on the request object to target a property; required when no default is configured.
+- \`client.runRealtimeReport(request)\` \u2014 run a realtime report. \`propertyId\` works the same as \`runReport\`.
+- \`client.getMetadata(propertyId?)\` \u2014 fetch available dimensions and metrics for a property.
+
+**Always pass \`propertyId\` explicitly** (the numeric id from the data overview) \u2014 the connection does not necessarily store a default property.
 
 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.
 
@@ -11016,30 +11018,33 @@ If a handler test fails with \`Connection proxy is not configured\`, retry \u201
 import { connection } from "@squadbase/vite-server/connectors/google-analytics-oauth";
 
 const ga = connection("<connectionId>");
+const propertyId = "123456789"; // numeric GA4 property id from the data overview
 
-// Authenticated fetch (returns standard Response)
-const res = await ga.request("properties/{propertyId}:runReport", {
-  method: "POST",
-  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
-});
-const data = await res.json();
-
-// Convenience methods
+// Convenience methods (pass propertyId explicitly)
 const { rows, rowCount } = await ga.runReport({
+  propertyId,
   dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
   dimensions: [{ name: "date" }],
   metrics: [{ name: "activeUsers" }, { name: "sessions" }],
   limit: 100,
 });
-const metadata = await ga.getMetadata();
+const metadata = await ga.getMetadata(propertyId);
 const realtime = await ga.runRealtimeReport({
+  propertyId,
   metrics: [{ name: "activeUsers" }],
   dimensions: [{ name: "country" }],
 });
+
+// Low-level authenticated fetch (write the numeric property id into the path)
+const res = await ga.request(\`properties/\${propertyId}:runReport\`, {
+  method: "POST",
+  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
+});
+const data = await res.json();
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`connector_google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{propertyId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u5BFE\u8C61\u30D7\u30ED\u30D1\u30C6\u30A3\u306F\u30D1\u30B9\u306B \`properties/{\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID}\` \u306E\u5F62\u3067\u76F4\u63A5\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\`{propertyId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u5834\u5408\u306E\u307F\u7F6E\u63DB\u3055\u308C\u307E\u3059\uFF09\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 - \`connector_google-analytics-oauth_listAccounts\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 - \`connector_google-analytics-oauth_listProperties\`: \u6307\u5B9A\u30A2\u30AB\u30A6\u30F3\u30C8\u306EGA4\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u30BF\u30FC\u30B2\u30C3\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u9078\u629E\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 
@@ -11075,10 +11080,12 @@ averageSessionDuration, conversions, totalRevenue
 \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
 
 SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\uFF09:
-- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\`path\` \u306F \`https://analyticsdata.googleapis.com/v1beta/\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059\uFF09\u3002
-- \`client.runReport(request)\` \u2014 GA4 \u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002
-- \`client.runRealtimeReport(request)\` \u2014 \u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002
-- \`client.getMetadata()\` \u2014 \u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u3092\u53D6\u5F97\u3002
+- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\`path\` \u306F \`https://analyticsdata.googleapis.com/v1beta/\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059\u3002\`{propertyId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u5834\u5408\u306E\u307F\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\uFF09\u3002
+- \`client.runReport(request)\` \u2014 GA4 \u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002\u30EA\u30AF\u30A8\u30B9\u30C8\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306B \`propertyId\`\uFF08\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID\uFF09\u3092\u6307\u5B9A\u3057\u3066\u5BFE\u8C61\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u6C7A\u3081\u307E\u3059\u3002\u30C7\u30D5\u30A9\u30EB\u30C8\u672A\u8A2D\u5B9A\u306E\u5834\u5408\u306F\u5FC5\u9808\u3067\u3059\u3002
+- \`client.runRealtimeReport(request)\` \u2014 \u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002\`propertyId\` \u306E\u6271\u3044\u306F \`runReport\` \u3068\u540C\u3058\u3067\u3059\u3002
+- \`client.getMetadata(propertyId?)\` \u2014 \u6307\u5B9A\u30D7\u30ED\u30D1\u30C6\u30A3\u306E\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u3092\u53D6\u5F97\u3002
+
+**\`propertyId\` \u306F\u5FC5\u305A\u660E\u793A\u7684\u306B\u6E21\u3057\u3066\u304F\u3060\u3055\u3044**\uFF08\u30C7\u30FC\u30BF\u6982\u8981\u306B\u8F09\u3063\u3066\u3044\u308B\u6570\u5024ID\uFF09\u3002\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u4FDD\u5B58\u3055\u308C\u3066\u3044\u308B\u3068\u306F\u9650\u308A\u307E\u305B\u3093\u3002
 
 \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\u3002\u901A\u5E38\u306F\u30B5\u30F3\u30C9\u30DC\u30C3\u30AF\u30B9\u306E\u521D\u671F\u5316\u4E2D\u306B\u8D77\u304D\u307E\u3059\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
 
@@ -11088,26 +11095,29 @@ SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9
 import { connection } from "@squadbase/vite-server/connectors/google-analytics-oauth";
 
 const ga = connection("<connectionId>");
+const propertyId = "123456789"; // \u30C7\u30FC\u30BF\u6982\u8981\u306B\u8F09\u3063\u3066\u3044\u308B\u6570\u5024\u306E GA4 \u30D7\u30ED\u30D1\u30C6\u30A3ID
 
-// Authenticated fetch (returns standard Response)
-const res = await ga.request("properties/{propertyId}:runReport", {
-  method: "POST",
-  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
-});
-const data = await res.json();
-
-// Convenience methods
+// \u4FBF\u5229\u30E1\u30BD\u30C3\u30C9\uFF08propertyId \u3092\u660E\u793A\u7684\u306B\u6E21\u3059\uFF09
 const { rows, rowCount } = await ga.runReport({
+  propertyId,
   dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
   dimensions: [{ name: "date" }],
   metrics: [{ name: "activeUsers" }, { name: "sessions" }],
   limit: 100,
 });
-const metadata = await ga.getMetadata();
+const metadata = await ga.getMetadata(propertyId);
 const realtime = await ga.runRealtimeReport({
+  propertyId,
   metrics: [{ name: "activeUsers" }],
   dimensions: [{ name: "country" }],
 });
+
+// \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID\u3092\u30D1\u30B9\u306B\u76F4\u63A5\u66F8\u304F\uFF09
+const res = await ga.request(\`properties/\${propertyId}:runReport\`, {
+  method: "POST",
+  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
+});
+const data = await res.json();
 \`\`\``
   },
   tools: tools16,
@@ -47691,8 +47701,14 @@ function getSkippedServerLogics() {
 }
 var viteServer = null;
 function validateHandlerPath(dirPath, handlerPath) {
-  const absolute = path2.resolve(dirPath, handlerPath);
   const normalizedDir = path2.resolve(dirPath);
+  const dirBase = path2.basename(normalizedDir);
+  let normalized = handlerPath.replace(/^\.?[/\\]/, "");
+  const prefix = dirBase + "/";
+  if (normalized.startsWith(prefix)) {
+    normalized = normalized.slice(prefix.length);
+  }
+  const absolute = path2.resolve(dirPath, normalized);
   if (!absolute.startsWith(normalizedDir + path2.sep)) {
     throw new Error(`Handler path escapes server-logic directory: ${handlerPath}`);
   }
@@ -47701,19 +47717,29 @@ function validateHandlerPath(dirPath, handlerPath) {
   }
   return absolute;
 }
-async function loadTypeScriptHandler(absolutePath) {
-  let mod;
+var bundledHandlers = {};
+function registerBundledHandlers(handlers) {
+  bundledHandlers = handlers;
+}
+async function loadTypeScriptHandler(slug, absolutePath) {
   if (viteServer) {
     const module = viteServer.moduleGraph.getModuleById(absolutePath);
     if (module) viteServer.moduleGraph.invalidateModule(module);
-    mod = await viteServer.ssrLoadModule(absolutePath);
-  } else {
-    const { pathToFileURL } = await import("url");
-    mod = await import(pathToFileURL(absolutePath).href);
+    const mod = await viteServer.ssrLoadModule(absolutePath);
+    const handler2 = mod.default;
+    if (typeof handler2 !== "function") {
+      throw new Error(`Handler must export a default function: ${absolutePath}`);
+    }
+    return handler2;
+  }
+  if (!(slug in bundledHandlers)) {
+    throw new Error(
+      `Bundled handler not found for server logic: ${slug} (not compiled into the build)`
+    );
   }
-  const handler = mod.default;
+  const handler = bundledHandlers[slug];
   if (typeof handler !== "function") {
-    throw new Error(`Handler must export a default function: ${absolutePath}`);
+    throw new Error(`Server logic '${slug}' must export a default function`);
   }
   return handler;
 }
@@ -48010,7 +48036,7 @@ app.get("/:slug", async (c) => {
   }
   try {
     if (ds._isTypescript && ds._tsHandlerPath) {
-      const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+      const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
       const result = await handler(c);
       return result;
     } else {
@@ -48038,7 +48064,7 @@ app.post("/:slug", async (c) => {
     const ttl = cacheConfig?.ttl ?? 0;
     if (ttl <= 0) {
       if (ds._isTypescript && ds._tsHandlerPath) {
-        const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+        const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
         const result = await handler(c);
         return result;
       } else {
@@ -48062,7 +48088,7 @@ app.post("/:slug", async (c) => {
         void (async () => {
           try {
             if (ds._isTypescript && ds._tsHandlerPath) {
-              const tsHandler = await loadTypeScriptHandler(ds._tsHandlerPath);
+              const tsHandler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
               const freshResponse = await tsHandler(c);
               const outcome = await cacheTypescriptResponse(freshResponse);
               if (outcome.cacheable) {
@@ -48086,7 +48112,7 @@ app.post("/:slug", async (c) => {
       }
     }
     if (ds._isTypescript && ds._tsHandlerPath) {
-      const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+      const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
       const response = await handler(c);
       const outcome = await cacheTypescriptResponse(response);
       if (outcome.cacheable) {
@@ -48550,5 +48576,6 @@ export {
   src_default as default,
   getQuery,
   loadConnections,
+  registerBundledHandlers,
   storage
 };

package/dist/main.d.ts

@@ -1,4 +1,5 @@
 import app from './index.js';
+export { registerBundledHandlers } from './index.js';
 import 'hono/types';
 import 'hono';
 

package/dist/main.js

@@ -10547,8 +10547,8 @@ init_parameter_definition();
 var parameters16 = {
   propertyId: new ParameterDefinition({
     slug: "property-id",
-    name: "Google Analytics Property ID",
-    description: "The Google Analytics 4 property ID (e.g., 123456789). Can be found in GA4 Admin > Property Settings.",
+    name: "Default Property ID",
+    description: "Optional default Google Analytics 4 property ID (e.g., 123456789) used when a request does not specify one. Can be found in GA4 Admin > Property Settings. Leave empty to always pass the property ID per request.",
     envVarBaseKey: "GA_OAUTH_PROPERTY_ID",
     type: "text",
     secret: false,
@@ -10861,7 +10861,7 @@ var inputSchema25 = z25.object({
   connectionId: z25.string().describe("ID of the Google Analytics OAuth connection to use"),
   method: z25.enum(["GET", "POST"]).describe("HTTP method"),
   path: z25.string().describe(
-    "API path appended to https://analyticsdata.googleapis.com/v1beta/ (e.g., 'properties/{propertyId}:runReport'). {propertyId} is automatically replaced."
+    "API path appended to https://analyticsdata.googleapis.com/v1beta/ (e.g., 'properties/123456789:runReport'). Write the numeric property id directly; the {propertyId} placeholder is only substituted when a default property is configured on the connection."
   ),
   body: z25.record(z25.string(), z25.unknown()).optional().describe("POST request body (JSON)")
 });
@@ -10880,7 +10880,7 @@ var requestTool4 = new ConnectorTool({
   name: "request",
   description: `Send authenticated requests to the Google Analytics Data API v1beta.
 Authentication is handled automatically via OAuth proxy.
-{propertyId} in the path is automatically replaced with the connection's property ID.`,
+Write the numeric property id directly into the path (e.g. properties/123456789:runReport). The {propertyId} placeholder is only substituted when a default property is configured on the connection.`,
   inputSchema: inputSchema25,
   outputSchema: outputSchema25,
   async execute({ connectionId, method, path: path6, body }, connections, config) {
@@ -10967,7 +10967,7 @@ var googleAnalyticsOauthConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`connector_google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. The {propertyId} placeholder in paths is automatically replaced. Authentication is configured automatically via OAuth.
+- \`connector_google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. Write the target property into the path as \`properties/{numericPropertyId}\` (the \`{propertyId}\` placeholder is only substituted when a default property is configured on the connection). Authentication is configured automatically via OAuth.
 - \`connector_google-analytics-oauth_listAccounts\`: List accessible Google Analytics accounts. Use during setup to discover available accounts.
 - \`connector_google-analytics-oauth_listProperties\`: List GA4 properties for a given account. Use during setup to select the target property.
 
@@ -11003,10 +11003,12 @@ averageSessionDuration, conversions, totalRevenue
 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.
 
 SDK surface (client created via \`connection(connectionId)\`):
-- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (\`path\` is appended to \`https://analyticsdata.googleapis.com/v1beta/\`).
-- \`client.runReport(request)\` \u2014 run a GA4 report.
-- \`client.runRealtimeReport(request)\` \u2014 run a realtime report.
-- \`client.getMetadata()\` \u2014 fetch available dimensions and metrics.
+- \`client.request(path, init?)\` \u2014 low-level authenticated fetch (\`path\` is appended to \`https://analyticsdata.googleapis.com/v1beta/\`; \`{propertyId}\` placeholders are auto-replaced only when a default property is configured on the connection).
+- \`client.runReport(request)\` \u2014 run a GA4 report. Set \`propertyId\` (bare numeric id) on the request object to target a property; required when no default is configured.
+- \`client.runRealtimeReport(request)\` \u2014 run a realtime report. \`propertyId\` works the same as \`runReport\`.
+- \`client.getMetadata(propertyId?)\` \u2014 fetch available dimensions and metrics for a property.
+
+**Always pass \`propertyId\` explicitly** (the numeric id from the data overview) \u2014 the connection does not necessarily store a default property.
 
 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.
 
@@ -11016,30 +11018,33 @@ If a handler test fails with \`Connection proxy is not configured\`, retry \u201
 import { connection } from "@squadbase/vite-server/connectors/google-analytics-oauth";
 
 const ga = connection("<connectionId>");
+const propertyId = "123456789"; // numeric GA4 property id from the data overview
 
-// Authenticated fetch (returns standard Response)
-const res = await ga.request("properties/{propertyId}:runReport", {
-  method: "POST",
-  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
-});
-const data = await res.json();
-
-// Convenience methods
+// Convenience methods (pass propertyId explicitly)
 const { rows, rowCount } = await ga.runReport({
+  propertyId,
   dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
   dimensions: [{ name: "date" }],
   metrics: [{ name: "activeUsers" }, { name: "sessions" }],
   limit: 100,
 });
-const metadata = await ga.getMetadata();
+const metadata = await ga.getMetadata(propertyId);
 const realtime = await ga.runRealtimeReport({
+  propertyId,
   metrics: [{ name: "activeUsers" }],
   dimensions: [{ name: "country" }],
 });
+
+// Low-level authenticated fetch (write the numeric property id into the path)
+const res = await ga.request(\`properties/\${propertyId}:runReport\`, {
+  method: "POST",
+  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
+});
+const data = await res.json();
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`connector_google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{propertyId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u5BFE\u8C61\u30D7\u30ED\u30D1\u30C6\u30A3\u306F\u30D1\u30B9\u306B \`properties/{\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID}\` \u306E\u5F62\u3067\u76F4\u63A5\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\`{propertyId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u5834\u5408\u306E\u307F\u7F6E\u63DB\u3055\u308C\u307E\u3059\uFF09\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 - \`connector_google-analytics-oauth_listAccounts\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 - \`connector_google-analytics-oauth_listProperties\`: \u6307\u5B9A\u30A2\u30AB\u30A6\u30F3\u30C8\u306EGA4\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u30BF\u30FC\u30B2\u30C3\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u9078\u629E\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 
@@ -11075,10 +11080,12 @@ averageSessionDuration, conversions, totalRevenue
 \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
 
 SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\uFF09:
-- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\`path\` \u306F \`https://analyticsdata.googleapis.com/v1beta/\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059\uFF09\u3002
-- \`client.runReport(request)\` \u2014 GA4 \u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002
-- \`client.runRealtimeReport(request)\` \u2014 \u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002
-- \`client.getMetadata()\` \u2014 \u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u3092\u53D6\u5F97\u3002
+- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\`path\` \u306F \`https://analyticsdata.googleapis.com/v1beta/\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059\u3002\`{propertyId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u308B\u5834\u5408\u306E\u307F\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\uFF09\u3002
+- \`client.runReport(request)\` \u2014 GA4 \u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002\u30EA\u30AF\u30A8\u30B9\u30C8\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306B \`propertyId\`\uFF08\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID\uFF09\u3092\u6307\u5B9A\u3057\u3066\u5BFE\u8C61\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u6C7A\u3081\u307E\u3059\u3002\u30C7\u30D5\u30A9\u30EB\u30C8\u672A\u8A2D\u5B9A\u306E\u5834\u5408\u306F\u5FC5\u9808\u3067\u3059\u3002
+- \`client.runRealtimeReport(request)\` \u2014 \u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u3092\u5B9F\u884C\u3002\`propertyId\` \u306E\u6271\u3044\u306F \`runReport\` \u3068\u540C\u3058\u3067\u3059\u3002
+- \`client.getMetadata(propertyId?)\` \u2014 \u6307\u5B9A\u30D7\u30ED\u30D1\u30C6\u30A3\u306E\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u3092\u53D6\u5F97\u3002
+
+**\`propertyId\` \u306F\u5FC5\u305A\u660E\u793A\u7684\u306B\u6E21\u3057\u3066\u304F\u3060\u3055\u3044**\uFF08\u30C7\u30FC\u30BF\u6982\u8981\u306B\u8F09\u3063\u3066\u3044\u308B\u6570\u5024ID\uFF09\u3002\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306B\u30C7\u30D5\u30A9\u30EB\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u304C\u4FDD\u5B58\u3055\u308C\u3066\u3044\u308B\u3068\u306F\u9650\u308A\u307E\u305B\u3093\u3002
 
 \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\u3002\u901A\u5E38\u306F\u30B5\u30F3\u30C9\u30DC\u30C3\u30AF\u30B9\u306E\u521D\u671F\u5316\u4E2D\u306B\u8D77\u304D\u307E\u3059\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
 
@@ -11088,26 +11095,29 @@ SDK\uFF08\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9
 import { connection } from "@squadbase/vite-server/connectors/google-analytics-oauth";
 
 const ga = connection("<connectionId>");
+const propertyId = "123456789"; // \u30C7\u30FC\u30BF\u6982\u8981\u306B\u8F09\u3063\u3066\u3044\u308B\u6570\u5024\u306E GA4 \u30D7\u30ED\u30D1\u30C6\u30A3ID
 
-// Authenticated fetch (returns standard Response)
-const res = await ga.request("properties/{propertyId}:runReport", {
-  method: "POST",
-  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
-});
-const data = await res.json();
-
-// Convenience methods
+// \u4FBF\u5229\u30E1\u30BD\u30C3\u30C9\uFF08propertyId \u3092\u660E\u793A\u7684\u306B\u6E21\u3059\uFF09
 const { rows, rowCount } = await ga.runReport({
+  propertyId,
   dateRanges: [{ startDate: "7daysAgo", endDate: "today" }],
   dimensions: [{ name: "date" }],
   metrics: [{ name: "activeUsers" }, { name: "sessions" }],
   limit: 100,
 });
-const metadata = await ga.getMetadata();
+const metadata = await ga.getMetadata(propertyId);
 const realtime = await ga.runRealtimeReport({
+  propertyId,
   metrics: [{ name: "activeUsers" }],
   dimensions: [{ name: "country" }],
 });
+
+// \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304D fetch\uFF08\u6570\u5024\u306E\u30D7\u30ED\u30D1\u30C6\u30A3ID\u3092\u30D1\u30B9\u306B\u76F4\u63A5\u66F8\u304F\uFF09
+const res = await ga.request(\`properties/\${propertyId}:runReport\`, {
+  method: "POST",
+  body: JSON.stringify({ dateRanges: [{ startDate: "7daysAgo", endDate: "today" }], metrics: [{ name: "activeUsers" }] }),
+});
+const data = await res.json();
 \`\`\``
   },
   tools: tools16,
@@ -47424,8 +47434,14 @@ function getSkippedServerLogics() {
 }
 var viteServer = null;
 function validateHandlerPath(dirPath, handlerPath) {
-  const absolute = path2.resolve(dirPath, handlerPath);
   const normalizedDir = path2.resolve(dirPath);
+  const dirBase = path2.basename(normalizedDir);
+  let normalized = handlerPath.replace(/^\.?[/\\]/, "");
+  const prefix = dirBase + "/";
+  if (normalized.startsWith(prefix)) {
+    normalized = normalized.slice(prefix.length);
+  }
+  const absolute = path2.resolve(dirPath, normalized);
   if (!absolute.startsWith(normalizedDir + path2.sep)) {
     throw new Error(`Handler path escapes server-logic directory: ${handlerPath}`);
   }
@@ -47434,19 +47450,29 @@ function validateHandlerPath(dirPath, handlerPath) {
   }
   return absolute;
 }
-async function loadTypeScriptHandler(absolutePath) {
-  let mod;
+var bundledHandlers = {};
+function registerBundledHandlers(handlers) {
+  bundledHandlers = handlers;
+}
+async function loadTypeScriptHandler(slug, absolutePath) {
   if (viteServer) {
     const module = viteServer.moduleGraph.getModuleById(absolutePath);
     if (module) viteServer.moduleGraph.invalidateModule(module);
-    mod = await viteServer.ssrLoadModule(absolutePath);
-  } else {
-    const { pathToFileURL } = await import("url");
-    mod = await import(pathToFileURL(absolutePath).href);
+    const mod = await viteServer.ssrLoadModule(absolutePath);
+    const handler2 = mod.default;
+    if (typeof handler2 !== "function") {
+      throw new Error(`Handler must export a default function: ${absolutePath}`);
+    }
+    return handler2;
+  }
+  if (!(slug in bundledHandlers)) {
+    throw new Error(
+      `Bundled handler not found for server logic: ${slug} (not compiled into the build)`
+    );
   }
-  const handler = mod.default;
+  const handler = bundledHandlers[slug];
   if (typeof handler !== "function") {
-    throw new Error(`Handler must export a default function: ${absolutePath}`);
+    throw new Error(`Server logic '${slug}' must export a default function`);
   }
   return handler;
 }
@@ -47743,7 +47769,7 @@ app.get("/:slug", async (c) => {
   }
   try {
     if (ds._isTypescript && ds._tsHandlerPath) {
-      const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+      const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
       const result = await handler(c);
       return result;
     } else {
@@ -47771,7 +47797,7 @@ app.post("/:slug", async (c) => {
     const ttl = cacheConfig?.ttl ?? 0;
     if (ttl <= 0) {
       if (ds._isTypescript && ds._tsHandlerPath) {
-        const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+        const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
         const result = await handler(c);
         return result;
       } else {
@@ -47795,7 +47821,7 @@ app.post("/:slug", async (c) => {
         void (async () => {
           try {
             if (ds._isTypescript && ds._tsHandlerPath) {
-              const tsHandler = await loadTypeScriptHandler(ds._tsHandlerPath);
+              const tsHandler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
               const freshResponse = await tsHandler(c);
               const outcome = await cacheTypescriptResponse(freshResponse);
               if (outcome.cacheable) {
@@ -47819,7 +47845,7 @@ app.post("/:slug", async (c) => {
       }
     }
     if (ds._isTypescript && ds._tsHandlerPath) {
-      const handler = await loadTypeScriptHandler(ds._tsHandlerPath);
+      const handler = await loadTypeScriptHandler(slug, ds._tsHandlerPath);
       const response = await handler(c);
       const outcome = await cacheTypescriptResponse(response);
       if (outcome.cacheable) {
@@ -48224,5 +48250,6 @@ src_default.get("*", (c) => {
 });
 var main_default = src_default;
 export {
-  main_default as default
+  main_default as default,
+  registerBundledHandlers
 };

package/dist/vite-plugin.d.ts

@@ -1,7 +1,6 @@
 import { Plugin } from 'vite';
 
 interface SquadbasePluginOptions {
-    buildEntry?: string;
     devEntry?: string;
     external?: string[];
     exclude?: RegExp[];