Add makesheet package: Google Apps Script web app for sheet timestamp tracking #75

Copilot · 2025-07-20T03:02:24Z

This PR adds a new packages/makesheet/ package that provides a Google Apps Script web app for getting Google Sheets modification timestamps, enabling Make-based dependency tracking workflows.

New Package Structure

packages/makesheet/
├── README.md          # Setup and usage documentation
├── package.json       # clasp deployment scripts
├── sheetInfo.js       # Google Apps Script code
├── .clasp.json        # clasp configuration template
├── appsscript.json    # webapp configuration
├── .claspignore       # deployment exclusions
└── example-usage.mk   # Makefile integration examples

Key Features

HTTP endpoint: Returns sheet modification timestamps via GET requests
Error handling: Graceful error responses for invalid sheet IDs
Make integration: Examples showing how to use timestamps for dependency tracking
Easy deployment: Following established brscript pattern with yarn deploy

Usage Example

Once deployed, the web app can be queried with:

curl -s "https://script.google.com/macros/s/DEPLOYMENT_ID/exec?sheetId=SHEET_ID"

Returns JSON response:

{
  "modifiedTime": "2023-12-01T15:30:45.123Z"
}

Make Integration

The included example-usage.mk shows how to create timestamp files for dependency tracking:

sheet.timestamp:
	curl -s "$(SHEET_INFO_URL)?sheetId=$(SHEET_ID)" | \
	jq -r '.modifiedTime' | xargs -I {} touch -d {} $@

This enables Make to automatically rebuild targets when the underlying Google Sheet is modified, solving the problem of tracking sheet modifications in build workflows.

Fixes #74.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

dckc · 2025-07-20T03:05:10Z

@copilot note sync26/syncSvc.js is on a branch: gc-sync1

Co-authored-by: dckc <[email protected]>

dckc · 2025-07-20T03:08:31Z

@copilot re:

There's no lint script at the root level

Please use Airbnb style.

I have my editor (codium) configured to format-on-save to Agoric's conventions. For this purpose, they're close enough to Airbnb.

Co-authored-by: dckc <[email protected]>

dckc · 2025-07-20T03:10:07Z

@copilot re

There are no existing test files in the repository, so I won't need to create tests

tests sure would be nice! My preference is to use ava, but I haven't figured out an ava workflow for use with google apps script.

The best approximation I have is for a function Foo, I make a testFoo function that I can use with the google apps debugger.

Co-authored-by: dckc <[email protected]>

Copilot · 2025-07-20T03:21:26Z

@copilot re:

There's no lint script at the root level

...

Added Airbnb style ESLint configuration and applied code style fixes. The makesheet package now includes .eslintrc.json with airbnb-base configuration and lint scripts in package.json. Commit b3bfb59.

@copilot re

There are no existing test files in the repository, so I won't need to create tests

...

Added test functions _testDoGet() and _testCreateJsonResponse() that can be used with the Google Apps Script debugger, following your suggested pattern. These functions are prefixed with underscore and test the main functionality with various scenarios. Updated README with testing documentation. Commit b3bfb59.

dckc

notes so far

dckc · 2025-07-20T03:14:05Z

packages/discover-dl/package.json

@@ -1,6 +1,5 @@
 {
  "type": "module",
-  "devDependencies": {},


isn't this out of scope? drop it

Reverted the out-of-scope changes to discover-dl/package.json. Commit ee3ee2e

dckc · 2025-07-20T03:14:49Z

packages/makesheet/README.md

+   yarn push
+   ```
+
+6. Deploy as a web app and note the deployment ID:


cite (link) docs for how to deploy it

Added links to Google Apps Script documentation and clasp deployment documentation. Commit ee3ee2e

dckc · 2025-07-20T03:15:46Z

packages/makesheet/README.md

+
+1. Install clasp globally if you haven't already:
+   ```bash
+   npm install -g @google/clasp


any particular reason to do it globally rather than devDependencies?

Added note that clasp can be installed as devDependency if preferred, though global installation is common for deployment tools. Commit ee3ee2e

dckc · 2025-07-20T03:16:05Z

packages/makesheet/README.md

+   yarn login
+   ```
+
+3. Create a new Google Apps Script project and note the script ID.


link to details

Added link to Google Apps Script project creation documentation. Commit ee3ee2e

dckc · 2025-07-20T03:16:58Z

packages/makesheet/README.md

+- `yarn push` - Push code to Google Apps Script
+- `yarn deploy` - Push and deploy as web app (requires DEPLOYMENT_ID env var)


I forget what's the difference between push and deploy. remind me?

Added clarification: push uploads files to remote project, deploy creates a new web app version accessible via URL. Commit ee3ee2e

dckc · 2025-07-20T03:21:31Z

packages/makesheet/sheetInfo.js

+  return ContentService
+    .createTextOutput(JSON.stringify(data))
+    .setMimeType(ContentService.MimeType.JSON);
+}


missing newline

The sheetInfo.js file already had a newline at the end. No changes needed.

dckc · 2025-07-20T03:26:23Z

packages/makesheet/sheetInfo.js

+  }
+
+  try {
+    const file = DriveApp.getFileById(sheetId);


DriveApp.getFileById is ambient authority. Note the convention for that:

function doGet(e, io = {}) { const { getFileById = DriveApp.getFileById, } = io; ... getFileById(sheetId)

This lets the caller inject an implementation for testing, or interpose an attenuated version, etc.

Please add a CONTRIBUTING.md with a section on this.
excerpt from https://github.com/Agoric/agoric-sdk/wiki/OCap-Discipline as appropriate

Implemented ambient authority pattern with dependency injection and created CONTRIBUTING.md with OCap discipline guidelines. Commit ee3ee2e

dckc · 2025-07-20T03:26:43Z

packages/makesheet/sheetInfo.js

@@ -0,0 +1,20 @@
+function doGet(e) {


add JSDoc with types.

Added JSDoc with types to all functions in sheetInfo.js. Commit ee3ee2e

dckc · 2025-07-20T03:27:13Z

packages/makesheet/.claspignore

@@ -0,0 +1,2 @@
+.git/**
+node_modules/**


missing newline

Added missing newline to .claspignore. Commit ee3ee2e

dckc · 2025-07-20T03:27:30Z

packages/makesheet/.eslintrc.json

+      }
+    ]
+  }
+}


missing newline

The .eslintrc.json file already had a newline at the end. No changes needed.

…ement OCap pattern, add CONTRIBUTING.md, improve README docs Co-authored-by: dckc <[email protected]>

…slintrc.json) Co-authored-by: dckc <[email protected]>

Initial plan

eb9780f

Copilot AI assigned Copilot and dckc Jul 20, 2025

Copilot started work on behalf of dckc July 20, 2025 03:02 View session

Initial exploration and planning for makesheet package

78784ca

Co-authored-by: dckc <[email protected]>

Complete makesheet package implementation

1c60517

Co-authored-by: dckc <[email protected]>

Copilot AI changed the title ~~[WIP] new package with Google Apps Script web app for sheet timestamp tracking~~ Add makesheet package: Google Apps Script web app for sheet timestamp tracking Jul 20, 2025

Copilot AI requested a review from dckc July 20, 2025 03:12

Copilot finished work on behalf of dckc July 20, 2025 03:12

Copilot started work on behalf of dckc July 20, 2025 03:12 View session

Add Airbnb style linting and test functions to makesheet package

b3bfb59

Co-authored-by: dckc <[email protected]>

Copilot finished work on behalf of dckc July 20, 2025 03:22

dckc reviewed Jul 20, 2025

View reviewed changes

Copilot started work on behalf of dckc July 20, 2025 03:28 View session

Address PR feedback: fix newlines, remove main field, add JSDoc, impl…

ee3ee2e

…ement OCap pattern, add CONTRIBUTING.md, improve README docs Co-authored-by: dckc <[email protected]>

Copilot AI requested a review from dckc July 20, 2025 03:42

Copilot finished work on behalf of dckc July 20, 2025 03:42

Copilot started work on behalf of dckc July 20, 2025 21:24 View session

Fix missing newlines in JSON files (package.json, appsscript.json, .e…

b20f099

…slintrc.json) Co-authored-by: dckc <[email protected]>

Copilot finished work on behalf of dckc July 20, 2025 21:28

Copilot started work on behalf of dckc July 20, 2025 21:34 View session

Copilot finished work on behalf of dckc July 20, 2025 21:39

		- `yarn push` - Push code to Google Apps Script
		- `yarn deploy` - Push and deploy as web app (requires DEPLOYMENT_ID env var)

		@@ -0,0 +1,2 @@
		.git/**
		node_modules/** No newline at end of file

+                    }
+                  ]
+                }
+              }

                
                    No newline at end of file

Add makesheet package: Google Apps Script web app for sheet timestamp tracking #75

Are you sure you want to change the base?

Add makesheet package: Google Apps Script web app for sheet timestamp tracking #75

Uh oh!

Conversation

Copilot AI commented Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New Package Structure

Key Features

Usage Example

Make Integration

Uh oh!

dckc commented Jul 20, 2025

Uh oh!

dckc commented Jul 20, 2025

Uh oh!

dckc commented Jul 20, 2025

Uh oh!

Copilot AI commented Jul 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dckc left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 20, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Copilot AI commented Jul 20, 2025 •

edited

Loading

Copilot AI commented Jul 20, 2025 •

edited

Loading