nuxt-google-sheets-import 0.1.6 → 0.1.8

package/README.md

@@ -1,154 +1,59 @@
-# @tribeweb/nuxt-google-sheets-import
+# nuxt-google-sheets-import
 
-Schema-driven Google Sheets importer for Nuxt Content.
+Schema-driven Google Sheets import and export workflows for Nuxt Content.
 
-## Status
+## Documentation
 
-This package scaffold is extracted from a working local module and is ready for standalone hardening/publishing.
+Project documentation now lives in the Docus site under [docs/content](docs/content).
 
-## Features
+- Intro: [docs/content/1.getting-started/2.introduction.md](docs/content/1.getting-started/2.introduction.md)
+- Installation: [docs/content/1.getting-started/3.installation.md](docs/content/1.getting-started/3.installation.md)
 
-- Fetches sheet list and values from Google Sheets
-- Validates/transforms rows with Zod schemas
-- Writes frontmatter markdown, JSON, or YAML output
-- Supports overwrite strategies (`overwrite`, `skip`, `overwrite-frontmatter`)
-- Exposes UI components and composables for import workflow
+Use this root README as a repo quick-start and contributor guide. Keep long-form user documentation in the docs site.
 
-## Install (workspace)
+## Module Quick Start
+
+Install:
 
 ```bash
-pnpm add @tribeweb/nuxt-google-sheets-import
+pnpm add nuxt-google-sheets-import
 ```
 
-## Configure
+Enable the module:
 
 ```ts
 // nuxt.config.ts
 export default defineNuxtConfig({
-  modules: ['@tribeweb/nuxt-google-sheets-import'],
+  modules: ['nuxt-google-sheets-import'],
   googleSheetsImport: {
     apiBase: '/api/google-sheets-import',
-    googleApiKeyRuntimeKey: 'googleApiKey',
-    defaultContentDir: 'content'
+    defaultContentDir: 'content/data'
   }
 })
 ```
 
-Collection type (`page` vs `data`) is derived from your Nuxt Content `content.config.ts` collection definitions.
-
-## Environment
+Environment:
 
 ```bash
 NUXT_GOOGLE_API_KEY=your_google_sheets_api_key
 ```
 
-## Google setup (permissions + API key)
-
-This module currently reads Google Sheets using an API key, so the sheet must be publicly readable.
-
-> Security note:
-> API-key access is best suited to non-sensitive sheets that are intentionally shared as `Anyone with the link`.
-> For private or sensitive spreadsheets, prefer OAuth 2.0 or a service account flow instead of API-key access.
-
-### 1) Set sheet permissions (Google Sheets)
-
-1. Open your sheet in Google Sheets.
-2. Click `Share`.
-3. Under `General access`, set to `Anyone with the link`.
-4. Set role to `Viewer`.
-5. Copy the spreadsheet ID from the URL:
-  - `https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/edit`
-
-If your Google Workspace policy blocks public link sharing, API key access will fail. In that case you need OAuth/service-account based auth (not part of this module yet).
-
-### 2) Create API key (Google Cloud Console)
-
-1. Open Google Cloud Console: https://console.cloud.google.com/
-2. Create/select a project.
-3. Enable Google Sheets API:
-  - https://console.cloud.google.com/apis/library/sheets.googleapis.com
-4. Create credentials (API key):
-  - https://console.cloud.google.com/apis/credentials
-  - Click `Create credentials` → `API key`
-5. Restrict the key (recommended):
-  - **API restrictions**: `Restrict key` → select `Google Sheets API`
-  - **Application restrictions**:
-    - Server usage: `IP addresses` (recommended for backend)
-    - Browser-only usage: `HTTP referrers` (if applicable)
-6. Put the key into `NUXT_GOOGLE_API_KEY`.
-
-### 3) Quick verification
-
-Call your module endpoint with a known sheet ID and confirm it returns tab metadata:
-
-`GET /api/google-sheets-import/sheets?spreadsheetId=<SPREADSHEET_ID>`
+## What The Module Provides
 
-### 4) Troubleshooting (common errors)
-
-- `403 PERMISSION_DENIED` / `The caller does not have permission`
-  - The sheet is not publicly readable with link.
-  - Fix: set `Share` → `General access` → `Anyone with the link` + `Viewer`.
-
-- `403 API key not valid` or `API has not been used in project`
-  - The key is wrong, restricted to the wrong API, or Sheets API is not enabled.
-  - Fix: enable `Google Sheets API` and ensure key restriction includes it.
-
-- `403 Requests from this referrer/IP are blocked`
-  - Your key application restrictions do not match where requests come from.
-  - Fix: update key restrictions (`IP addresses` for server use is preferred).
-
-- `404 Requested entity was not found`
-  - Spreadsheet ID is incorrect or malformed.
-  - Fix: copy ID from `https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/edit`.
-
-- `400 Unable to parse range`
-  - Invalid A1 range (for example typo in sheet tab or columns).
-  - Fix: verify tab name and use ranges like `A:Z`.
-
-## Exported runtime
-
-- Components: `GoogleSheetsImportSource`, `GoogleSheetsImportExecute`, `GoogleSheetsImportSchemaGuide`
-- Composables: `useGoogleSheetsImport`, `useGoogleSheetsImportWorkflow`
-
-### Schema helper component
-
-Use `GoogleSheetsImportSchemaGuide` to let editors choose a schema and see the expected Google Sheet column headers.
-
-```vue
-<GoogleSheetsImportSchemaGuide />
-```
+- A built-in route at `/google-sheets-import`
+- Tabbed workflow with schema setup, import, and export steps
+- Zod schema-driven row validation/transforms
+- Writes to markdown frontmatter, JSON, and YAML
+- Export helpers:
+  - copy TSV to clipboard for Google Sheets paste
+  - download CSV
 
-Benefits:
+Collection type (`page` vs `data`) is resolved from your Nuxt Content collections.
 
-- Reduces import failures by giving editors exact header names before filling a sheet
-- Supports nested/array header patterns used by schema mapping (for example `items[0].name`)
-- Uses a single column for arrays of scalar values (for example `tags` with `foo, bar, baz`)
-- For `page` collections, shows Nuxt Content built-in page override fields and allows copying them separately
-- Supports two copy modes:
-  - line-by-line copy
-  - CSV-row copy (pastes horizontally into Google Sheets)
+## Schema Source
 
-Optional prop:
-
-- `initialSchema?: string`
-
-### Suggested Cell Examples
-
-Use these value patterns when filling sheets:
-
-- `string`: `example text`
-- `number`: `123`
-- `boolean`: `true` or `false`
-- `enum` / `literal`: use one of the schema's allowed values
-- `date-like string`: `2026-01-01`
-- `string[]` (scalar array): `foo, bar, baz` in a single cell
-- `object[]` (array of objects): use indexed headers like `items[0].name`, `items[0].price`
-
-## Schema source
-
-The module resolves Zod schemas from Nuxt auto-imports using `#imports.schemas`.
-
-Define a `schemas` export in `~/utils/googleSheetImportSchemas.ts`:
+Define and export `schemas` in `~/utils/googleSheetImportSchemas.ts`.
+The module auto-imports it as `googleSheetsImportSchemas` in app and server runtime.
 
 ```ts
 export const schemas = {
@@ -157,61 +62,26 @@ export const schemas = {
 }
 ```
 
-## Playground smoke test (`values` + `write`)
-
-The playground includes:
-
-- `playground/utils/googleSheetImportSchemas.ts` (tiny local schema registry)
-- `POST /api/google-sheets-import/values-smoke` (local transform/validation payload)
-- `playground/scripts/smoke.mjs` (calls `values-smoke`, then module `write` for `frontmatter`, `json`, `yaml`)
-
-Run with Nuxt dev server active:
-
-```bash
-pnpm --dir packages/nuxt-google-sheets-import smoke:playground
-```
-
-Optional custom base URL:
-
-```bash
-SMOKE_BASE_URL=http://localhost:3000 pnpm --dir packages/nuxt-google-sheets-import smoke:playground
-```
+## Repository Development
 
-## Additional API endpoint
-
-- `GET {apiBase}/schema-columns`
-  - Query: `schema?`
-  - Returns:
-    - `schemas`: available schema keys
-    - `columns`: expected import header names for selected schema
-    - `collectionType`: `page | data | unknown`
-    - `pageOverrideColumns`: Nuxt Content page override fields (when `collectionType === 'page'`)
-
-## Publish checklist
-
-- Add playground integration tests for `/values` and `/write`
-- Add CI (`lint`, `typecheck`, `build`) and release workflow
-- Verify Nuxt 4 peer compatibility matrix
-
-## Publish (next step)
+Module development:
 
 ```bash
-pnpm --dir packages/nuxt-google-sheets-import release:check
+npm install
+npm run dev:prepare
+npm run test
 ```
 
-Then authenticate and publish:
+Playground app:
 
 ```bash
-npm login
-pnpm --dir packages/nuxt-google-sheets-import publish --access public
+npm run dev
 ```
 
-Or use one-command release scripts (bumps version + checks + publishes):
+Docs site:
 
 ```bash
-npm login
-pnpm --dir packages/nuxt-google-sheets-import release:patch
-# or: release:minor / release:major
+cd docs
+npm install
+npm run dev
 ```
-
-These scripts use `npm version --no-git-tag-version`, so they update `package.json` version without creating a git tag/commit.

package/dist/module.d.mts

@@ -2,7 +2,6 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 interface ModuleOptions {
     apiBase: string;
-    googleApiKeyRuntimeKey: string;
     defaultContentDir: string;
 }
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-google-sheets-import",
   "configKey": "googleSheetsImport",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, createResolver, extendPages, addServerHandler, addImportsDir, addComponentsDir, addImports, addServerImports } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addTemplate, extendPages, addServerHandler, addImportsDir, addComponentsDir, addImports, addServerImports } from '@nuxt/kit';
 
 const module$1 = defineNuxtModule({
   meta: {
@@ -6,21 +6,28 @@ const module$1 = defineNuxtModule({
     configKey: "googleSheetsImport"
   },
   moduleDependencies: {
+    "@nuxt/content": {
+      version: ">=3"
+    },
     "@nuxt/ui": {
       version: ">=4"
     }
   },
   defaults: {
     apiBase: "/api/google-sheets-import",
-    googleApiKeyRuntimeKey: "googleApiKey",
     defaultContentDir: "content/data"
   },
   setup(options, nuxt) {
     const resolver = createResolver(import.meta.url);
+    addTemplate({
+      filename: "googleSheetsImportSchemaExample.ts",
+      src: resolver.resolve("./runtime/app/examples/googleSheetsImportSchemasExample.ts"),
+      dst: "utils/googleSheetsImportSchemasExample.ts",
+      write: true
+    });
     nuxt.options.runtimeConfig.googleSheetsImport = {
       ...nuxt.options.runtimeConfig.googleSheetsImport,
       apiBase: options.apiBase,
-      googleApiKeyRuntimeKey: options.googleApiKeyRuntimeKey,
       defaultContentDir: options.defaultContentDir
     };
     nuxt.options.runtimeConfig.public.googleSheetsImport = {
@@ -28,12 +35,12 @@ const module$1 = defineNuxtModule({
       apiBase: options.apiBase,
       defaultContentDir: options.defaultContentDir
     };
-    nuxt.options.css.push(resolver.resolve("./runtime/assets/css/main.css"));
+    nuxt.options.css.push(resolver.resolve("./runtime/app/assets/css/main.css"));
     extendPages((pages) => {
       pages.push({
         name: "google-sheets-import",
         path: "/google-sheets-import",
-        file: resolver.resolve("./runtime/pages/google-sheets-import.vue")
+        file: resolver.resolve("./runtime/app/pages/google-sheets-import.vue")
       });
     });
     addServerHandler({
@@ -61,16 +68,11 @@ const module$1 = defineNuxtModule({
       method: "post",
       handler: resolver.resolve("./runtime/server/api/write.post")
     });
-    addImportsDir(resolver.resolve("./runtime/composables"));
+    addImportsDir(resolver.resolve("./runtime/app/composables"));
     addComponentsDir({
-      path: resolver.resolve("./runtime/components")
+      path: resolver.resolve("./runtime/app/components")
     });
     addImports([
-      {
-        from: "~/utils/googleSheetImportSchemas",
-        name: "schemas",
-        as: "googleSheetsImportSchemas"
-      },
       {
         from: resolver.resolve("./runtime/types/googleSheetsApi"),
         name: "GoogleSheetsApiValues",
@@ -104,8 +106,8 @@ const module$1 = defineNuxtModule({
     ]);
     addServerImports([
       {
-        from: "~/utils/googleSheetImportSchemas",
-        name: "schemas",
+        from: "~/utils/googleSheetsImportSchemas",
+        name: "googleSheetsImportSchemas",
         as: "googleSheetsImportSchemas"
       }
     ]);

package/dist/runtime/app/components/GoogleSheetsImportExport.vue

@@ -0,0 +1,212 @@
+<script setup>
+import { computed, ref, watch } from "vue";
+import { queryCollection, useAsyncData, useToast } from "#imports";
+import { useGoogleSheetsImport } from "../composables/useGoogleSheetsImport";
+import { copyTextWithSuccessToast } from "../utils/clipboard";
+import { toCsvRow, toTsvRow } from "../utils/delimited";
+import { flattenRecordToStringMap } from "../utils/pathMapping";
+const toast = useToast();
+const { getSchemaColumns } = useGoogleSheetsImport();
+const queryCollectionAny = queryCollection;
+function queryCollectionRows(collection) {
+  const query = queryCollectionAny(collection);
+  return query.all();
+}
+const selectedSchema = ref("");
+const {
+  data: rowsData,
+  pending,
+  error: loadError,
+  status,
+  execute,
+  clear
+} = useAsyncData(
+  async () => {
+    if (!selectedSchema.value) {
+      return [];
+    }
+    return await queryCollectionRows(selectedSchema.value);
+  },
+  {
+    immediate: false,
+    default: () => []
+  }
+);
+const {
+  data: schemaNames,
+  error: schemaNamesError
+} = useAsyncData(
+  "google-sheets-import-export-schemas",
+  async () => {
+    const response = await getSchemaColumns();
+    return response.schemas ?? [];
+  },
+  {
+    default: () => []
+  }
+);
+const rows = computed(() => rowsData.value ?? []);
+const error = computed(() => loadError.value?.message ?? schemaNamesError.value?.message ?? "");
+watch(selectedSchema, () => {
+  clear();
+});
+const schemaOptions = computed(() => (schemaNames.value ?? []).sort((left, right) => left.localeCompare(right)).map((schema) => ({ label: schema, value: schema })));
+const headers = computed(() => {
+  const all = /* @__PURE__ */ new Set();
+  for (const row of rows.value) {
+    flattenRecordToStringMap(row).forEach((_, key) => all.add(key));
+  }
+  return Array.from(all).sort((left, right) => left.localeCompare(right));
+});
+const csvText = computed(() => {
+  if (!headers.value.length) {
+    return "";
+  }
+  const lines = [];
+  lines.push(toCsvRow(headers.value));
+  for (const row of rows.value) {
+    const flat = flattenRecordToStringMap(row);
+    const values = headers.value.map((header) => flat.get(header) ?? "");
+    lines.push(toCsvRow(values));
+  }
+  return `${lines.join("\n")}
+`;
+});
+const tsvText = computed(() => {
+  if (!headers.value.length) {
+    return "";
+  }
+  const lines = [];
+  lines.push(toTsvRow(headers.value));
+  for (const row of rows.value) {
+    const flat = flattenRecordToStringMap(row);
+    const values = headers.value.map((header) => flat.get(header) ?? "");
+    lines.push(toTsvRow(values));
+  }
+  return `${lines.join("\n")}
+`;
+});
+const previewText = computed(() => {
+  if (!csvText.value) {
+    return "";
+  }
+  return csvText.value.split("\n").slice(0, 11).join("\n");
+});
+async function loadRecords() {
+  if (!selectedSchema.value) {
+    return;
+  }
+  await execute();
+  if (status.value === "success") {
+    toast.add({
+      title: "Export ready",
+      description: `Loaded ${rows.value.length} row(s) from collection ${selectedSchema.value}.`,
+      color: "success"
+    });
+  }
+}
+async function copyCsv() {
+  await copyTextWithSuccessToast({
+    text: tsvText.value,
+    toast,
+    description: "Tab-separated rows copied for Google Sheets paste.",
+    title: "Copied"
+  });
+}
+function downloadCsv() {
+  if (!csvText.value) {
+    return;
+  }
+  const blob = new Blob([csvText.value], { type: "text/csv;charset=utf-8" });
+  const url = URL.createObjectURL(blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = `${selectedSchema.value || "export"}.csv`;
+  link.click();
+  URL.revokeObjectURL(url);
+}
+</script>
+
+<template>
+  <div class="space-y-4">
+    <UAlert
+      title="Export Existing Content"
+      description="Load records from a Nuxt Content collection and export them as CSV for Google Sheets."
+      color="neutral"
+      variant="subtle"
+    />
+
+    <UAlert
+      v-if="error"
+      title="Could not load collection"
+      :description="error"
+      color="error"
+      variant="subtle"
+    />
+
+    <UFormField
+      label="Collection schema"
+      name="schema"
+      description="Pick the schema/collection to export."
+    >
+      <USelect
+        v-model="selectedSchema"
+        :items="schemaOptions"
+        value-key="value"
+        class="w-full max-w-sm"
+        icon="i-heroicons-cube-20-solid"
+      />
+    </UFormField>
+
+    <div class="flex flex-wrap gap-2">
+      <UButton
+        label="Load records"
+        icon="i-heroicons-arrow-down-tray-20-solid"
+        :disabled="!selectedSchema"
+        :loading="pending"
+        @click="loadRecords"
+      />
+      <UButton
+        label="Copy for Google Sheets"
+        icon="i-heroicons-clipboard-document-20-solid"
+        color="neutral"
+        variant="subtle"
+        :disabled="!tsvText"
+        @click="copyCsv"
+      />
+      <UButton
+        label="Download .csv"
+        icon="i-heroicons-document-arrow-down-20-solid"
+        color="neutral"
+        variant="subtle"
+        :disabled="!csvText"
+        @click="downloadCsv"
+      />
+    </div>
+
+    <UAlert
+      v-if="status === 'success'"
+      title="Export prepared"
+      :description="`${rows.length} row(s), ${headers.length} column(s).`"
+      color="success"
+      variant="subtle"
+    />
+
+    <UCollapsible
+      v-if="previewText"
+      class="flex flex-col gap-2 w-full"
+    >
+      <UButton
+        label="Preview CSV (first 10 rows)"
+        color="neutral"
+        variant="subtle"
+        trailing-icon="i-lucide-chevron-down"
+        block
+      />
+
+      <template #content>
+        <pre class="text-xs whitespace-pre-wrap">{{ previewText }}</pre>
+      </template>
+    </UCollapsible>
+  </div>
+</template>

package/dist/runtime/{components → app/components}/GoogleSheetsImportSchemaGuide.vue

@@ -2,6 +2,8 @@
 import { computed, onMounted, ref, watch } from "vue";
 import { useToast } from "#imports";
 import { useGoogleSheetsImport } from "../composables/useGoogleSheetsImport";
+import { copyTextWithSuccessToast } from "../utils/clipboard";
+import { toTsvRow } from "../utils/delimited";
 const props = defineProps({
   initialSchema: { type: String, required: false, default: "" }
 });
@@ -61,58 +63,36 @@ onMounted(async () => {
     await loadColumns(selectedSchema.value);
   }
 });
-function copyColumns() {
-  const content = columns.value.join("\n");
-  if (!content) {
-    return;
-  }
-  navigator.clipboard.writeText(content);
-  toast.add({
-    title: "Copied",
+async function copyColumns() {
+  await copyTextWithSuccessToast({
+    text: columns.value.join("\n"),
+    toast,
     description: "Column names copied to clipboard.",
-    color: "success"
+    title: "Copied"
   });
 }
-function csvRow(values) {
-  return values.map((value) => {
-    const escaped = value.replaceAll('"', '""');
-    return `"${escaped}"`;
-  }).join(",");
-}
-function copyColumnsCsv() {
-  const content = csvRow(columns.value);
-  if (!content) {
-    return;
-  }
-  navigator.clipboard.writeText(content);
-  toast.add({
-    title: "Copied",
-    description: "Column names copied as a CSV row.",
-    color: "success"
+async function copyColumnsTsv() {
+  await copyTextWithSuccessToast({
+    text: toTsvRow(columns.value),
+    toast,
+    description: "Column names copied as a tab-separated row for Google Sheets.",
+    title: "Copied"
   });
 }
-function copyPageOverrideColumns() {
-  const content = pageOverrideColumns.value.join("\n");
-  if (!content) {
-    return;
-  }
-  navigator.clipboard.writeText(content);
-  toast.add({
-    title: "Copied",
+async function copyPageOverrideColumns() {
+  await copyTextWithSuccessToast({
+    text: pageOverrideColumns.value.join("\n"),
+    toast,
     description: "Page override column names copied to clipboard.",
-    color: "success"
+    title: "Copied"
   });
 }
-function copyPageOverrideColumnsCsv() {
-  const content = csvRow(pageOverrideColumns.value);
-  if (!content) {
-    return;
-  }
-  navigator.clipboard.writeText(content);
-  toast.add({
-    title: "Copied",
-    description: "Page override column names copied as a CSV row.",
-    color: "success"
+async function copyPageOverrideColumnsTsv() {
+  await copyTextWithSuccessToast({
+    text: toTsvRow(pageOverrideColumns.value),
+    toast,
+    description: "Page override column names copied as a tab-separated row for Google Sheets.",
+    title: "Copied"
   });
 }
 </script>
@@ -170,11 +150,11 @@ function copyPageOverrideColumnsCsv() {
           @click="copyColumns"
         />
         <UButton
-          label="Copy as CSV row"
+          label="Copy as tab-separated row"
           icon="i-heroicons-table-cells-20-solid"
           color="neutral"
           variant="subtle"
-          @click="copyColumnsCsv"
+          @click="copyColumnsTsv"
         />
       </div>
       <pre class="text-xs whitespace-pre-wrap">{{ columns.join("\n") }}</pre>
@@ -200,11 +180,11 @@ function copyPageOverrideColumnsCsv() {
             @click="copyPageOverrideColumns"
           />
           <UButton
-            label="Copy overrides as CSV row"
+            label="Copy overrides as tab-separated row"
             icon="i-heroicons-table-cells-20-solid"
             color="neutral"
             variant="subtle"
-            @click="copyPageOverrideColumnsCsv"
+            @click="copyPageOverrideColumnsTsv"
           />
         </div>
         <pre class="text-xs whitespace-pre-wrap">{{ pageOverrideColumns.join("\n") }}</pre>

package/dist/runtime/app/examples/googleSheetsImportSchemasExample.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runtime/app/pages/google-sheets-import.d.vue.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/pages/google-sheets-import.vue

@@ -0,0 +1,45 @@
+<script setup>
+import { ref } from "vue";
+const sheetsList = ref([
+  { id: "1NKS0cTX6u5urtgQ3Q4Z2motiR2-9JmyPxcd05yVc1bc", label: "Metzner" },
+  { id: "1tGZCEoiikXfg3mOpfVWWTS1SSSsj18xv6Z3owrnnt4s", label: "Example Sheet" }
+]);
+const items = ref([
+  {
+    label: "Setup Google Sheet",
+    icon: "i-lucide-layout-dashboard",
+    slot: "sheet"
+  },
+  {
+    label: "Import data",
+    icon: "i-lucide-upload",
+    slot: "import"
+  },
+  {
+    label: "Export data",
+    icon: "i-lucide-download",
+    slot: "export"
+  }
+]);
+</script>
+
+<template>
+  <UContainer class="max-w-36">
+    <UTabs
+      :items="items"
+      variant="link"
+      color="neutral"
+      class="w-full"
+    >
+      <template #sheet>
+        <GoogleSheetsImportSchemaGuide :initial-schema="'Example Sheet'" />
+      </template>
+      <template #import>
+        <GoogleSheetsImportSource :google-sheets="sheetsList" />
+      </template>
+      <template #export>
+        <GoogleSheetsImportExport />
+      </template>
+    </UTabs>
+  </UContainer>
+</template>

package/dist/runtime/app/pages/google-sheets-import.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/utils/clipboard.d.ts

@@ -0,0 +1,15 @@
+interface ToastLike {
+    add: (payload: {
+        title?: string;
+        description?: string;
+        color?: 'success' | 'error' | 'warning' | 'info' | 'neutral';
+    }) => void;
+}
+interface CopyTextWithToastOptions {
+    text: string;
+    toast: ToastLike;
+    description: string;
+    title?: string;
+}
+export declare function copyTextWithSuccessToast(options: CopyTextWithToastOptions): Promise<boolean>;
+export {};

package/dist/runtime/app/utils/clipboard.js

@@ -0,0 +1,12 @@
+export async function copyTextWithSuccessToast(options) {
+  if (!options.text) {
+    return false;
+  }
+  await navigator.clipboard.writeText(options.text);
+  options.toast.add({
+    title: options.title ?? "Copied",
+    description: options.description,
+    color: "success"
+  });
+  return true;
+}

package/dist/runtime/app/utils/delimited.d.ts

@@ -0,0 +1,2 @@
+export declare function toCsvRow(values: string[]): string;
+export declare function toTsvRow(values: string[]): string;

package/dist/runtime/app/utils/delimited.js

@@ -0,0 +1,9 @@
+export function toCsvRow(values) {
+  return values.map((value) => {
+    const escaped = value.replaceAll('"', '""');
+    return `"${escaped}"`;
+  }).join(",");
+}
+export function toTsvRow(values) {
+  return values.map((value) => value.replace(/[\t\r\n]+/g, " ")).join("	");
+}

package/dist/runtime/app/utils/pathMapping.d.ts

@@ -0,0 +1,4 @@
+export type PathSegment = string | number;
+export declare function parseHeaderPath(header: string): PathSegment[];
+export declare function setDeep(target: Record<string, unknown>, path: PathSegment[], value: unknown): void;
+export declare function flattenRecordToStringMap(record: Record<string, unknown>, prefix?: string): Map<string, string>;

package/dist/runtime/app/utils/pathMapping.js

@@ -0,0 +1,86 @@
+const EXCLUDED_EXPORT_PATHS = /* @__PURE__ */ new Set(["__hash__", "body"]);
+export function parseHeaderPath(header) {
+  const tokens = [];
+  const parts = header.split(".");
+  for (const part of parts) {
+    const matches = part.matchAll(/([^[]+)|(\[(\d+)\])/g);
+    for (const match of matches) {
+      if (match[1]) {
+        tokens.push(match[1]);
+      }
+      if (match[3]) {
+        tokens.push(Number.parseInt(match[3], 10));
+      }
+    }
+  }
+  return tokens;
+}
+export function setDeep(target, path, value) {
+  if (!path.length) {
+    return;
+  }
+  let cursor = target;
+  for (let index = 0; index < path.length; index++) {
+    const key = path[index];
+    if (key === void 0) {
+      return;
+    }
+    const isLast = index === path.length - 1;
+    const nextKey = path[index + 1];
+    if (isLast) {
+      cursor[key] = value;
+      return;
+    }
+    if (cursor[key] === void 0) {
+      cursor[key] = typeof nextKey === "number" ? [] : {};
+    }
+    const nextCursor = cursor[key];
+    if (!nextCursor || typeof nextCursor !== "object") {
+      return;
+    }
+    cursor = nextCursor;
+  }
+}
+export function flattenRecordToStringMap(record, prefix = "") {
+  const out = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(record)) {
+    const path = prefix ? `${prefix}.${key}` : key;
+    if (EXCLUDED_EXPORT_PATHS.has(path)) {
+      continue;
+    }
+    if (value === null || value === void 0) {
+      out.set(path, "");
+      continue;
+    }
+    if (Array.isArray(value)) {
+      if (value.every((item) => item === null || ["string", "number", "boolean"].includes(typeof item))) {
+        out.set(path, value.map((item) => item == null ? "" : String(item)).join(", "));
+        continue;
+      }
+      for (let index = 0; index < value.length; index++) {
+        const item = value[index];
+        const arrayPath = `${path}[${index}]`;
+        if (item && typeof item === "object" && !Array.isArray(item)) {
+          flattenRecordToStringMap(item, arrayPath).forEach((nestedValue, nestedKey) => {
+            out.set(nestedKey, nestedValue);
+          });
+        } else {
+          out.set(arrayPath, item == null ? "" : String(item));
+        }
+      }
+      continue;
+    }
+    if (value instanceof Date) {
+      out.set(path, value.toISOString());
+      continue;
+    }
+    if (typeof value === "object") {
+      flattenRecordToStringMap(value, path).forEach((nestedValue, nestedKey) => {
+        out.set(nestedKey, nestedValue);
+      });
+      continue;
+    }
+    out.set(path, String(value));
+  }
+  return out;
+}

package/dist/runtime/server/api/sheets.get.js

@@ -6,8 +6,8 @@ const querySchema = z.object({
   spreadsheetId: z.string().length(44)
 });
 export default defineEventHandler(async (event) => {
-  const { googleSheetsImport } = useRuntimeConfig();
-  const apiKey = googleSheetsImport?.googleApiKeyRuntimeKey;
+  const config = useRuntimeConfig(event);
+  const apiKey = config.googleApiKey;
   const { spreadsheetId } = await getValidatedQuery(event, (query) => querySchema.parse(query));
   if (!apiKey || typeof apiKey !== "string") {
     throw createError({ statusCode: 500, statusMessage: `Missing Google API key in nuxt.config googleSheetsImport: { googleApiKeyRuntimeKey: '${apiKey}' }` });

package/dist/runtime/server/api/values.post.js

@@ -10,8 +10,8 @@ const bodySchema = z.object({
 });
 export default defineEventHandler(async (event) => {
   const body = bodySchema.parse(await readBody(event));
-  const { googleSheetsImport } = useRuntimeConfig();
-  const apiKey = googleSheetsImport?.googleApiKeyRuntimeKey;
+  const config = useRuntimeConfig(event);
+  const apiKey = config.googleApiKey;
   if (!apiKey || typeof apiKey !== "string") {
     throw createError({ statusCode: 500, statusMessage: `Missing Google API key in nuxt.config googleSheetsImport: { googleApiKeyRuntimeKey: '${apiKey}' }` });
   }

package/dist/runtime/server/utils/transform.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { parseHeaderPath, setDeep } from "../../../runtime/app/utils/pathMapping";
 function isZodType(value) {
   return typeof value === "object" && value !== null && "_def" in value;
 }
@@ -47,48 +48,6 @@ function hasWrapper(schema, wrapper) {
   }
   return false;
 }
-function parseHeaderPath(header) {
-  const tokens = [];
-  const parts = header.split(".");
-  for (const part of parts) {
-    const matches = part.matchAll(/([^[]+)|(\[(\d+)\])/g);
-    for (const match of matches) {
-      if (match[1]) {
-        tokens.push(match[1]);
-      }
-      if (match[3]) {
-        tokens.push(Number.parseInt(match[3], 10));
-      }
-    }
-  }
-  return tokens;
-}
-function setDeep(target, path, value) {
-  if (!path.length) {
-    return;
-  }
-  let cursor = target;
-  for (let index = 0; index < path.length; index++) {
-    const key = path[index];
-    if (key === void 0) {
-      return;
-    }
-    const isLast = index === path.length - 1;
-    const nextKey = path[index + 1];
-    if (isLast) {
-      cursor[key] = value;
-      return;
-    }
-    if (cursor[key] === void 0) {
-      cursor[key] = typeof nextKey === "number" ? [] : {};
-    }
-    const nextCursor = cursor[key];
-    if (!nextCursor || typeof nextCursor !== "object") {
-      return;
-    }
-    cursor = nextCursor;
-  }
-}
 function getObjectShape(schema) {
   const unwrapped = unwrapSchema(schema);
   if (!unwrapped) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-google-sheets-import",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Schema-driven Google Sheets import module for Nuxt Content",
   "repository": "tribeweb/nuxt-google-sheets-import",
   "license": "MIT",
@@ -23,9 +23,12 @@
     "dist"
   ],
   "workspaces": [
-    "playground"
+    "playground",
+    "docs"
   ],
   "scripts": {
+    "docs:dev": "cd docs && nuxt dev --extends docus",
+    "docs:build": "nuxt build docs --extends docus",
     "prepack": "nuxt-module-build build",
     "dev": "npm run dev:prepare && nuxt dev playground",
     "dev:build": "nuxt build playground",

package/dist/runtime/pages/google-sheets-import.vue

@@ -1,14 +0,0 @@
-<script setup>
-import { ref } from "vue";
-const sheetsList = ref([
-  { id: "1NKS0cTX6u5urtgQ3Q4Z2motiR2-9JmyPxcd05yVc1bc", label: "Metzner" },
-  { id: "1tGZCEoiikXfg3mOpfVWWTS1SSSsj18xv6Z3owrnnt4s", label: "Example Sheet" }
-]);
-</script>
-
-<template>
-  <UContainer>
-    <GoogleSheetsImportSchemaGuide />
-    <GoogleSheetsImportSource :google-sheets="sheetsList" />
-  </UContainer>
-</template>