@datalackey/gas-demodulify-plugin 0.1.0

package/dist/plugin/code-emission/wildcards-resolution-helpers.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTsEntrypoint = resolveTsEntrypoint;
+exports.assertNoWildcardReexports = assertNoWildcardReexports;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const Logger_1 = require("../Logger");
+/**
+ * Resolves the single TypeScript-authored entrypoint.
+ */
+function resolveTsEntrypoint(compilation) {
+    Logger_1.Logger.debug("Resolving TypeScript entrypoint");
+    const candidates = [];
+    for (const [entryName, rawEntrypoint] of compilation.entrypoints) {
+        Logger_1.Logger.debug(`Inspecting entrypoint '${entryName}'`);
+        const entrypoint = rawEntrypoint;
+        let chunks = [];
+        if (entrypoint.chunks !== undefined) {
+            chunks = Array.from(entrypoint.chunks);
+        }
+        else if (entrypoint.getEntrypointChunk !== undefined) {
+            chunks = [entrypoint.getEntrypointChunk()];
+        }
+        Logger_1.Logger.debug(`Entrypoint '${entryName}' has ${chunks.length} chunk(s)`);
+        for (const chunk of chunks) {
+            const runtime = chunk.runtime;
+            for (const entryModule of compilation.chunkGraph.getChunkEntryModulesIterable(chunk)) {
+                const resource = entryModule.resource; // chunk entry module has resource?
+                if (typeof resource === "string" &&
+                    (resource.endsWith(".ts") || resource.endsWith(".tsx"))) {
+                    Logger_1.Logger.debug(`Found TS entry module for '${entryName}': ${resource}`);
+                    candidates.push({
+                        entryName,
+                        entryModule: entryModule,
+                        runtime,
+                        chunks,
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    if (candidates.length === 0) {
+        throw new Error("No TypeScript entrypoint found");
+    }
+    if (candidates.length > 1) {
+        const names = candidates.map(c => c.entryName).join(", ");
+        throw new Error(`GASDemodulifyPlugin requires exactly one TypeScript entrypoint, but found ${candidates.length}: [${names}]`);
+    }
+    const resolved = candidates[0];
+    Logger_1.Logger.debug(`Resolved entrypoint '${resolved.entryName}' with ${resolved.chunks.length} chunk(s)`);
+    return resolved;
+}
+// Wildcard re-export guard
+const exportStarRe = /export\s*\*\s*(?:as\s+\w+\s*)?(?:from\s+['"]|;)/;
+function assertNoWildcardReexports(compilation, entry) {
+    const chunks = entry.chunks;
+    for (const chunk of chunks) {
+        for (const module of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+            const resource = module.resource;
+            if (typeof resource === "string" &&
+                (resource.endsWith(".ts") || resource.endsWith(".tsx"))) {
+                const abs = path_1.default.isAbsolute(resource)
+                    ? resource
+                    : path_1.default.resolve(compilation.options?.context ??
+                        process.cwd(), resource);
+                if (fs_1.default.existsSync(abs)) {
+                    const content = fs_1.default.readFileSync(abs, "utf8");
+                    if (exportStarRe.test(content)) {
+                        throw unsupportedWildcardError(`Module: ${abs}`);
+                    }
+                }
+            }
+            const exportsInfo = compilation.moduleGraph.getExportsInfo(module);
+            const other = exportsInfo.otherExportsInfo;
+            if (other !== undefined && other.provided === true) {
+                const resourceLabel = typeof resource === "string" ? resource : "<synthetic>";
+                throw unsupportedWildcardError(`Module: ${resourceLabel}`);
+            }
+        }
+    }
+}
+function unsupportedWildcardError(details) {
+    return new Error([
+        "Unsupported wildcard re-export detected.",
+        "",
+        "This build uses a wildcard re-export (`export *` or `export * as ns`), which cannot be safely",
+        "flattened into a Google Apps Script global namespace.",
+        "",
+        "Workaround:",
+        "Replace wildcard re-exports with explicit named re-exports:",
+        '  export { foo, bar } from "./module";',
+        "",
+        details ?? "",
+    ].join("\n"));
+}
+//# sourceMappingURL=wildcards-resolution-helpers.js.map

package/dist/plugin/code-emission/wildcards-resolution-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcards-resolution-helpers.js","sourceRoot":"","sources":["../../../src/plugin/code-emission/wildcards-resolution-helpers.ts"],"names":[],"mappings":";;;;;AAsBA,kDA0DC;AAKD,8DAsCC;AAxHD,4CAAoB;AACpB,gDAAwB;AACxB,sCAAmC;AAcnC;;GAEG;AACH,SAAgB,mBAAmB,CAAC,WAAwB;IACxD,eAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAyB,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;QAC/D,eAAM,CAAC,KAAK,CAAC,0BAA0B,SAAS,GAAG,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,aAA0C,CAAC;QAC9D,IAAI,MAAM,GAAY,EAAE,CAAC;QACzB,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,UAAU,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,GAAG,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,eAAM,CAAC,KAAK,CAAC,eAAe,SAAS,SAAS,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QAExE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAE9B,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnF,MAAM,QAAQ,GAAI,WAAsC,CAAC,QAAQ,CAAC,CAAC,mCAAmC;gBAEtG,IACI,OAAO,QAAQ,KAAK,QAAQ;oBAC5B,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EACzD,CAAC;oBACC,eAAM,CAAC,KAAK,CAAC,8BAA8B,SAAS,MAAM,QAAQ,EAAE,CAAC,CAAC;oBAEtE,UAAU,CAAC,IAAI,CAAC;wBACZ,SAAS;wBACT,WAAW,EAAE,WAAW;wBACxB,OAAO;wBACP,MAAM;qBACT,CAAC,CAAC;oBACH,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,IAAI,KAAK,CACX,6EAA6E,UAAU,CAAC,MAAM,MAAM,KAAK,GAAG,CAC/G,CAAC;IACN,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,eAAM,CAAC,KAAK,CACR,wBAAwB,QAAQ,CAAC,SAAS,UAAU,QAAQ,CAAC,MAAM,CAAC,MAAM,WAAW,CACxF,CAAC;IAEF,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,2BAA2B;AAC3B,MAAM,YAAY,GAAG,iDAAiD,CAAC;AAEvE,SAAgB,yBAAyB,CACrC,WAAwB,EACxB,KAAyB;IAEzB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAiB,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,UAAU,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,QAAQ,GAAI,MAAiC,CAAC,QAAQ,CAAC;YAE7D,IACI,OAAO,QAAQ,KAAK,QAAQ;gBAC5B,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EACzD,CAAC;gBACC,MAAM,GAAG,GAAG,cAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;oBACjC,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,cAAI,CAAC,OAAO,CACP,WAAkD,CAAC,OAAO,EAAE,OAAO;wBAChE,OAAO,CAAC,GAAG,EAAE,EACjB,QAAQ,CACX,CAAC;gBAER,IAAI,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrB,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBAC7C,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC7B,MAAM,wBAAwB,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACL,CAAC;YACL,CAAC;YAED,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACnE,MAAM,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACjD,MAAM,aAAa,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC9E,MAAM,wBAAwB,CAAC,WAAW,aAAa,EAAE,CAAC,CAAC;YAC/D,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgB;IAC9C,OAAO,IAAI,KAAK,CACZ;QACI,0CAA0C;QAC1C,EAAE;QACF,+FAA+F;QAC/F,uDAAuD;QACvD,EAAE;QACF,aAAa;QACb,6DAA6D;QAC7D,wCAAwC;QACxC,EAAE;QACF,OAAO,IAAI,EAAE;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAC;AACN,CAAC"}

package/dist/plugin/invariants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GAS demodulification invariants.
+ *
+ * These patterns must NEVER appear in emitted GAS output.
+ * Their presence indicates leaked Webpack / module-system artifacts.
+ *
+ * IMPORTANT:
+ *  - These are UNANCHORED patterns by design.
+ *  - We must detect violations anywhere in the output, regardless of formatting.
+ *  - Might flag false positives in string literals or comments, but that's acceptable
+ *    since such cases are likely to be rare and indicative of potential issues anyway.
+ */
+export declare const FORBIDDEN_WEBPACK_RUNTIME_PATTERNS: readonly RegExp[];

package/dist/plugin/invariants.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORBIDDEN_WEBPACK_RUNTIME_PATTERNS = void 0;
+/**
+ * GAS demodulification invariants.
+ *
+ * These patterns must NEVER appear in emitted GAS output.
+ * Their presence indicates leaked Webpack / module-system artifacts.
+ *
+ * IMPORTANT:
+ *  - These are UNANCHORED patterns by design.
+ *  - We must detect violations anywhere in the output, regardless of formatting.
+ *  - Might flag false positives in string literals or comments, but that's acceptable
+ *    since such cases are likely to be rare and indicative of potential issues anyway.
+ */
+exports.FORBIDDEN_WEBPACK_RUNTIME_PATTERNS = [
+    /__webpack_/i, // any webpack runtime helper
+    /\.__esModule\b/i, // ESM interop artifact
+    /\bexports\./i, // CommonJS named export
+    /\bmodule\.exports\b/i, // CommonJS default export
+    /Object\.defineProperty\s*\(\s*exports\b/i, // CJS export descriptor
+];
+//# sourceMappingURL=invariants.js.map

package/dist/plugin/invariants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariants.js","sourceRoot":"","sources":["../../src/plugin/invariants.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACU,QAAA,kCAAkC,GAAsB;IACjE,aAAa,EAAE,6BAA6B;IAC5C,iBAAiB,EAAE,uBAAuB;IAC1C,cAAc,EAAE,wBAAwB;IACxC,sBAAsB,EAAE,0BAA0B;IAClD,0CAA0C,EAAE,wBAAwB;CAC9D,CAAC"}

package/dist/plugin/plugin-configuration-options/options.schema.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+/**
+ * Public configuration options for GASDemodulifyPlugin.
+ *
+ * These options are supplied by the consumer when constructing the plugin
+ * instance in `webpack.config.js`.
+ *
+ * They control:
+ *  - how emitted symbols are namespaced
+ *  - which logical subsystem is being built
+ *  - which artifacts are emitted
+ *  - how much diagnostic output is produced
+ *
+ * This schema is the single source of truth for:
+ *  - runtime validation
+ *  - defaulting behavior
+ *  - TypeScript type inference
+ */
+export declare const DemodulifyOptionsSchema: z.ZodObject<{
+    namespaceRoot: z.ZodDefault<z.ZodString>;
+    subsystem: z.ZodDefault<z.ZodString>;
+    buildMode: z.ZodDefault<z.ZodEnum<{
+        gas: "gas";
+        ui: "ui";
+        common: "common";
+    }>>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        info: "info";
+        debug: "debug";
+        silent: "silent";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Fully-resolved, runtime-valid plugin options.
+ *
+ * Notes:
+ *  - All fields are guaranteed to be present
+ *  - Defaults have already been applied
+ *  - This type should be used internally by the plugin
+ */
+export type GASDemodulifyOptions = z.infer<typeof DemodulifyOptionsSchema>;

package/dist/plugin/plugin-configuration-options/options.schema.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DemodulifyOptionsSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Public configuration options for GASDemodulifyPlugin.
+ *
+ * These options are supplied by the consumer when constructing the plugin
+ * instance in `webpack.config.js`.
+ *
+ * They control:
+ *  - how emitted symbols are namespaced
+ *  - which logical subsystem is being built
+ *  - which artifacts are emitted
+ *  - how much diagnostic output is produced
+ *
+ * This schema is the single source of truth for:
+ *  - runtime validation
+ *  - defaulting behavior
+ *  - TypeScript type inference
+ */
+exports.DemodulifyOptionsSchema = zod_1.z.object({
+    /**
+     * The root global namespace under which all generated symbols are attached.
+     *
+     * Example:
+     *   namespaceRoot: "MYADDON"
+     *
+     * This value becomes the first segment of every emitted namespace path.
+     */
+    namespaceRoot: zod_1.z.string().min(1, "namespaceRoot must be a non-empty string").default("DEFAULT"),
+    /**
+     * Logical subsystem name.
+     *
+     * Examples:
+     *  - "GAS"
+     *  - "UI"
+     *  - "COMMON"
+     *
+     * Combined with `namespaceRoot`, this produces the final namespace
+     * used for symbol attachment (e.g. "DEFAULT.GAS").
+     */
+    subsystem: zod_1.z.string().min(1, "subsystem must be a non-empty string").default("DEFAULT"),
+    /**
+     * Controls which artifacts are emitted by the plugin.
+     *
+     *  - "gas"    → emit `.gs` only
+     *  - "ui"     → emit `.html` only
+     *  - "common" → emit both `.gs` and `.html`
+     *
+     * NOTE:
+     * The current implementation wires this option through the plugin API,
+     * but artifact branching logic is handled elsewhere.
+     */
+    buildMode: zod_1.z.enum(["gas", "ui", "common"]).default("gas"),
+    /**
+     * Optional logging verbosity.
+     *
+     *  - "silent" → no output
+     *  - "info"   → high-level lifecycle messages
+     *  - "debug"  → detailed internal diagnostics
+     *
+     * If omitted, logging defaults to "info".
+     */
+    logLevel: zod_1.z.enum(["silent", "info", "debug"]).default("info"),
+});
+//# sourceMappingURL=options.schema.js.map

package/dist/plugin/plugin-configuration-options/options.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.schema.js","sourceRoot":"","sources":["../../../src/plugin/plugin-configuration-options/options.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C;;;;;;;OAOG;IACH,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0CAA0C,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAE/F;;;;;;;;;;OAUG;IACH,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAEvF;;;;;;;;;;OAUG;IACH,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzD;;;;;;;;OAQG;IACH,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CAChE,CAAC,CAAC"}

package/dist/plugin/plugin-configuration-options/validateAndNormalizePluginOptions.d.ts

@@ -0,0 +1,5 @@
+import { GASDemodulifyOptions } from "./options.schema";
+/**
+ * Parse, validate, and normalize (i.e., apply defaults where field is missing) the user-supplied plugin options.
+ */
+export declare function validateAndNormalizePluginOptions(input?: unknown): GASDemodulifyOptions;

package/dist/plugin/plugin-configuration-options/validateAndNormalizePluginOptions.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAndNormalizePluginOptions = validateAndNormalizePluginOptions;
+const options_schema_1 = require("./options.schema");
+/**
+ * Parse, validate, and normalize (i.e., apply defaults where field is missing) the user-supplied plugin options.
+ */
+function validateAndNormalizePluginOptions(input) {
+    // If caller passes nothing, we still want schema defaults to apply.
+    return options_schema_1.DemodulifyOptionsSchema.parse(input ?? {});
+}
+//# sourceMappingURL=validateAndNormalizePluginOptions.js.map

package/dist/plugin/plugin-configuration-options/validateAndNormalizePluginOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAndNormalizePluginOptions.js","sourceRoot":"","sources":["../../../src/plugin/plugin-configuration-options/validateAndNormalizePluginOptions.ts"],"names":[],"mappings":";;AAKA,8EAGC;AARD,qDAAiF;AAEjF;;GAEG;AACH,SAAgB,iCAAiC,CAAC,KAAe;IAC7D,oEAAoE;IACpE,OAAO,wCAAuB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@datalackey/gas-demodulify-plugin",
+  "version": "0.1.0",
+  "description": "Webpack plugin: emits GAS-safe JavaScript with modules flattened & mapped to hierarchical namespaces",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "lint": "eslint 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run lint && npm run typecheck",
+    "compile": "npx nx run gas-demodulify:compile",
+    "format": "prettier --write . --log-level warn",
+    "format:check": "prettier --check .",
+    "test": "jest",
+    "docs:toc:update": "update-markdown-toc --recursive .",
+    "docs:toc:check": "update-markdown-toc --check --recursive .",
+    "build": "rm -rf dist && npm run lint && npm run format && npm run docs:toc:update && npm run compile && npm run test",
+    "package:release": "nx run gas-demodulify:release"
+  },
+  "peerDependencies": {
+    "webpack": "^5.0.0"
+  },
+  "devDependencies": {
+    "@datalackey/update-markdown-toc": "^1.0.4",
+    "@nx/eslint": "^22.5.0",
+    "@nx/jest": "^22.5.0",
+    "@nx/js": "^22.5.0",
+    "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "eslint": "^8.57.1",
+    "jest": "^29.7.0",
+    "nx": "^22.5.0",
+    "outdent": "^0.8.0",
+    "prettier": "^3.8.1",
+    "strip-comments": "^2.0.1",
+    "ts-dedent": "^2.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-loader": "^9.0.0",
+    "typescript": "^5.9.3",
+    "webpack": "^5.0.0",
+    "webpack-cli": "^5.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.3.5"
+  }
+}