hikoutei 0.5.11 → 0.5.13

package/dist/cli/sheetsFactory.js

@@ -0,0 +1,71 @@
+/**
+ * Spreadsheet creation for `hikoutei setup`.
+ *
+ * The setup CLI creates the sync spreadsheet with the freshly provisioned
+ * service-account key, so the service account owns the spreadsheet and no
+ * sharing step is needed. The production implementation uses
+ * google-auth-library plus @googleapis/sheets (already root dependencies);
+ * tests inject a fake creator, so unit tests never touch the network.
+ *
+ * The API response is treated as untrusted input: it is validated by a
+ * runtime guard before it is promoted into the internal result shape.
+ */
+import { GoogleAuth } from "google-auth-library";
+import { sheets } from "@googleapis/sheets";
+/** OAuth scope required to create and write spreadsheets. */
+export const SPREADSHEETS_SCOPE = "https://www.googleapis.com/auth/spreadsheets";
+/** Template for the human-facing spreadsheet edit URL. */
+export const SPREADSHEET_EDIT_URL_TEMPLATE = "https://docs.google.com/spreadsheets/d/<id>/edit";
+/**
+ * Production spreadsheet creator.
+ *
+ * Authenticates with the given service-account key file and calls
+ * `spreadsheets.create`. Throws on failure; the setup flow maps any throw to
+ * the `sheet_create_failed` error code. The key file path is never included
+ * in error output.
+ */
+export function createGoogleSheetsSpreadsheetCreator() {
+    return async (request) => {
+        // google-auth-library may resolve to a version nested under googleapis-common
+        // that differs from the top-level one; the boundary cast keeps any SDK
+        // version mismatch contained in this module.
+        const auth = new GoogleAuth({
+            keyFile: request.keyPath,
+            scopes: [SPREADSHEETS_SCOPE],
+        });
+        const client = sheets({ version: "v4", auth });
+        const response = await client.spreadsheets.create({
+            requestBody: { properties: { title: request.title } },
+        });
+        return extractSpreadsheetCreateResult(response.data);
+    };
+}
+/** Builds the public edit URL for a spreadsheet id. */
+export function spreadsheetEditUrl(spreadsheetId) {
+    return SPREADSHEET_EDIT_URL_TEMPLATE.replace("<id>", spreadsheetId);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Validates the raw `spreadsheets.create` payload and promotes it into the
+ * internal result shape.
+ *
+ * The response is untrusted SDK data, so `spreadsheetId` must be proven to be
+ * a non-empty string. When the API omits `spreadsheetUrl` (it can), the URL
+ * is derived from the id deterministically.
+ */
+export function extractSpreadsheetCreateResult(data) {
+    if (!isRecord(data)) {
+        throw new Error("spreadsheets.create returned a non-object payload");
+    }
+    const { spreadsheetId, spreadsheetUrl } = data;
+    if (typeof spreadsheetId !== "string" || spreadsheetId === "") {
+        throw new Error("spreadsheets.create response is missing a spreadsheet id");
+    }
+    if (typeof spreadsheetUrl === "string" && spreadsheetUrl !== "") {
+        return { spreadsheetId, spreadsheetUrl };
+    }
+    return { spreadsheetId, spreadsheetUrl: spreadsheetEditUrl(spreadsheetId) };
+}
+//# sourceMappingURL=sheetsFactory.js.map

package/dist/cli/sheetsFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetsFactory.js","sourceRoot":"","sources":["../../src/cli/sheetsFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AAEjF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,kDAAkD,CAAC;AAsBhG;;;;;;;GAOG;AACH,MAAM,UAAU,oCAAoC;IAClD,OAAO,KAAK,EAAE,OAAiC,EAAoC,EAAE;QACnF,8EAA8E;QAC9E,uEAAuE;QACvE,6CAA6C;QAC7C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,CAAC,kBAAkB,CAAC;SAC7B,CAA0B,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;YAChD,WAAW,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE;SACtD,CAAC,CAAC;QACH,OAAO,8BAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,6BAA6B,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAa;IAC1D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hikoutei",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "description": "Typed repository and safe write layer for Google Sheets-backed MVPs. SQLite-authoritative entity lifecycle with asynchronous Google Sheets projection.",
   "repository": {
     "type": "git",
@@ -16,6 +16,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "hikoutei": "./dist/cli/setup.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",