notion-batch-apply-template 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuta Nagamiya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# Notion Batch Apply Template
+
+This Node.js script allows you to batch apply a Notion template to all existing pages within a specific data source.
+
+> [!WARNING]
+> This script is configured with `erase_content: true`.
+> All existing content within the target pages will be permanently deleted and replaced by the specified template.
+> Please test this on a duplicate or dummy database before running it on production data.
+
+## Installation
+
+> [!NOTE]
+> If you are using npx, you can skip the installation step and run the script directly with `npx notion-batch-apply-template ...`.
+
+Install the package using npm:
+
+```bash
+npm install notion-batch-apply-template
+```
+
+## Setup
+
+Set your [Notion integration token](https://www.notion.com/help/create-integrations-with-the-notion-api) as an environment variable:
+
+```bash
+export NOTION_TOKEN="your_integration_token"
+```
+
+## Usage
+
+Run the script:
+
+```bash
+notion-batch-apply-template --data-source <data_source_id> [options]
+```
+
+### Arguments
+
+| Argument                    | Required | Default   | Description                                                                       |
+|-----------------------------|----------|-----------|-----------------------------------------------------------------------------------|
+| `--data-source` (or `--ds`) | Yes      | -         | The ID of the target data source.                                                 |
+| `--template`                | No       | `default` | The ID or URL of the template to apply. If omitted, the default template is used. |
+| `--delay`                   | No       | `150`     | Delay in milliseconds between API calls to avoid rate limiting.                   |
+
+> [!TIP]
+> To get a data source ID from the Notion app, the settings menu for a database includes a "Copy data source ID" button under "Manage data sources":
+> ![](https://mintcdn.com/notion-demo/S-I3qLQnwRa7HjdK/images/reference/image-4.png?w=2500&fit=max&auto=format&n=S-I3qLQnwRa7HjdK&q=85&s=02948f93889722aa8adfce042bdd8b54)
+
+## License
+
+Notion Batch Apply Template is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
+
+### Disclaimer
+
+This tool performs destructive operations.
+The author is not responsible for any data loss or damages resulting from the use of this script.
+Use it at your own risk.

package/batch-apply-template.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+import { Client } from '@notionhq/client';
+
+const notion = new Client({ auth: process.env.NOTION_TOKEN });
+
+function normalizeUuid(uuid) {
+  const hex = uuid.replace(/-/g, '');
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
+function extractUuid(str) {
+  const m = String(str).match(
+    /\b[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{12}\b/
+  );
+  if (!m) {
+    throw new Error(`No UUID found in input: ${str}`);
+  }
+  return normalizeUuid(m[0]);
+}
+
+function parseArgs(argv) {
+  const args = {
+    dataSource: null,
+    template: null,
+    delayMs: 150,
+  };
+
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--data-source' || a === '--ds') {
+      args.dataSource = argv[++i];
+    } else if (a === '--template') {
+      args.template = argv[++i];
+    } else if (a === '--delay') {
+      args.delayMs = Number(argv[++i] ?? '150');
+    } else {
+      throw new Error(`Unknown argument: ${a}`);
+    }
+  }
+
+  if (!args.dataSource) {
+    throw new Error('Missing required argument: --data-source (or --ds)');
+  }
+  if (Number.isNaN(args.delayMs) || args.delayMs < 0) {
+    throw new Error('Invalid value for --delay (must be a non-negative number)');
+  }
+
+  return args;
+}
+
+async function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+async function listAllPagesInDataSource(dataSourceId) {
+  const pages = [];
+  let cursor = undefined;
+
+  while (true) {
+    const res = await notion.dataSources.query({
+      data_source_id: dataSourceId,
+      start_cursor: cursor,
+      page_size: 100,
+    });
+
+    pages.push(...res.results);
+    if (!res.has_more) {
+      break;
+    }
+    cursor = res.next_cursor;
+  }
+
+  return pages;
+}
+
+async function applyTemplateToPage(pageId, templateId) {
+  const template = templateId
+    ? { type: 'template_id', template_id: templateId }
+    : { type: 'default' };
+
+  return notion.pages.update({
+    page_id: pageId,
+    erase_content: true,
+    template: template,
+  });
+}
+
+async function main() {
+  if (!process.env.NOTION_TOKEN) {
+    throw new Error('Missing environment variable: NOTION_TOKEN');
+  }
+
+  const { dataSource, template, delayMs } = parseArgs(process.argv);
+
+  const dataSourceId = extractUuid(dataSource);
+  const templateId = template ? extractUuid(template) : null;
+
+  console.log(`Data source: ${dataSourceId}`);
+  console.log(`Template: ${templateId ?? 'default'}`);
+  console.log(`Delay: ${delayMs} ms`);
+
+  const pages = await listAllPagesInDataSource(dataSourceId);
+  console.log(`Pages: ${pages.length}`);
+
+  for (let i = 0; i < pages.length; i++) {
+    const pageId = pages[i].id;
+
+    try {
+      await applyTemplateToPage(pageId, templateId);
+      console.log(`[${i + 1}/${pages.length}] OK: ${pageId}`);
+    } catch (e) {
+      const details = e?.body ? JSON.stringify(e.body) : String(e);
+      console.error(`[${i + 1}/${pages.length}] FAILED: ${pageId} | ${details}`);
+    }
+
+    await sleep(delayMs);
+  }
+}
+
+main().catch((e) => {
+  console.error(e?.message ? `ERROR: ${e.message}` : `ERROR: ${String(e)}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "notion-batch-apply-template",
+  "type": "module",
+  "version": "0.2.0",
+  "description": "This Node.js script allows you to batch apply a Notion template to all existing pages within a specific database.",
+  "keywords": [
+    "notion",
+    "cli",
+    "batch-apply-template"
+  ],
+  "license": "MIT",
+  "bin": {
+    "notion-batch-apply-template": "batch-apply-template.js"
+  },
+  "dependencies": {
+    "@notionhq/client": "^5.11.1"
+  }
+}