@gasboost/client 0.1.0

package/dist/AppsScriptClient.d.ts

@@ -0,0 +1,30 @@
+import { AppsScriptJob } from "./job/AppsScriptJob";
+type RpcResponse = {
+    contents: string;
+};
+type RpcDefinition = {
+    args: unknown[];
+    result: unknown;
+};
+type RpcApp = Record<string, RpcDefinition>;
+type AppsScriptClient<TApp extends RpcApp> = {
+    [K in keyof TApp]: TApp[K] extends {
+        args: infer TArgs extends unknown[];
+        result: infer TResult;
+    } ? (...args: TArgs) => Promise<TResult> : never;
+};
+export declare const appsScriptTransport: {
+    call(name: string, args: unknown[]): Promise<RpcResponse>;
+};
+interface AppsScriptJobs {
+    start: <T>(label: string, execute: () => Promise<T>) => Promise<T>;
+    cancel: (jobId: string) => void;
+    retry: (jobId: string) => void;
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => AppsScriptJob<any>[];
+}
+export declare function appsScriptClient<TApp extends RpcApp>(): {
+    client: AppsScriptClient<TApp>;
+    jobs: AppsScriptJobs;
+};
+export {};

package/dist/AppsScriptClient.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appsScriptTransport = void 0;
+exports.appsScriptClient = appsScriptClient;
+const google_1 = require("./google");
+const AppsScriptJobQueue_1 = require("./job/AppsScriptJobQueue");
+const AppsScriptJobRunner_1 = require("./job/AppsScriptJobRunner");
+const AppsScriptJobStore_1 = require("./job/AppsScriptJobStore");
+exports.appsScriptTransport = {
+    call(name, args) {
+        return new Promise((resolve, reject) => {
+            google_1.google.script.run
+                .withSuccessHandler(resolve)
+                .withFailureHandler(reject)[name](...args);
+        });
+    },
+};
+function appsScriptClient() {
+    const jobQueue = new AppsScriptJobQueue_1.AppsScriptJobQueue();
+    const jobRunner = new AppsScriptJobRunner_1.AppsScriptJobRunner(jobQueue);
+    const jobStore = (0, AppsScriptJobStore_1.appsScriptJobStore)(jobRunner);
+    const client = new Proxy({}, {
+        get(_target, property) {
+            if (typeof property !== "string") {
+                return undefined;
+            }
+            return (...args) => {
+                return jobQueue.enqueue(property, async () => {
+                    const res = await exports.appsScriptTransport.call(property, args);
+                    return JSON.parse(res.contents);
+                });
+            };
+        },
+    });
+    const jobs = {
+        start: jobQueue.enqueue.bind(jobQueue),
+        cancel: jobRunner.cancel.bind(jobRunner),
+        retry: jobRunner.retry.bind(jobRunner),
+        subscribe: jobStore.subscribe.bind(jobStore),
+        getSnapshot: jobStore.getSnapshot.bind(jobStore),
+    };
+    return { client, jobs };
+}

package/dist/AppsScriptJob.d.ts

@@ -0,0 +1,28 @@
+export declare class AppsScriptJob<T> {
+    readonly label: string;
+    readonly execute: () => Promise<T>;
+    private resolve;
+    private reject;
+    readonly id: string;
+    readonly createdAt: Date;
+    private _startedAt;
+    private _endedAt;
+    private _result;
+    private _error;
+    constructor(label: string, execute: () => Promise<T>, resolve: (value: T) => void, reject: (reason?: any) => void, id?: string, createdAt?: Date);
+    start(): void;
+    success(result: T): void;
+    fail(error: unknown): void;
+    get endedAt(): Date | null;
+    get result(): T | null;
+    get error(): unknown;
+    isPending(): boolean;
+    isRunning(): boolean;
+    isSuccess(): boolean;
+    isFailed(): boolean;
+    get status(): "failed" | "pending" | "running" | "success" | "unknown";
+    cancel(): boolean;
+}
+export declare class AppsScriptJobCancelledError extends Error {
+    constructor();
+}

package/dist/AppsScriptJob.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptJobCancelledError = exports.AppsScriptJob = void 0;
+class AppsScriptJob {
+    label;
+    execute;
+    resolve;
+    reject;
+    id;
+    createdAt;
+    _startedAt = null;
+    _endedAt = null;
+    _result = null;
+    _error = null;
+    constructor(label, execute, resolve, reject, id = crypto.randomUUID(), createdAt = new Date()) {
+        this.label = label;
+        this.execute = execute;
+        this.resolve = resolve;
+        this.reject = reject;
+        this.id = id;
+        this.createdAt = createdAt;
+    }
+    start() {
+        this._startedAt = new Date();
+    }
+    success(result) {
+        this._endedAt = new Date();
+        this._result = result;
+        this.resolve(result);
+    }
+    fail(error) {
+        this._endedAt = new Date();
+        this._error = error;
+        this.reject(error);
+    }
+    get endedAt() {
+        return this._endedAt;
+    }
+    get result() {
+        return this._result;
+    }
+    get error() {
+        return this._error;
+    }
+    isPending() {
+        return this._startedAt === null;
+    }
+    isRunning() {
+        return this._startedAt !== null && this._endedAt === null;
+    }
+    isSuccess() {
+        return this._endedAt !== null && this._error === null;
+    }
+    isFailed() {
+        return this._endedAt !== null && this._error !== null;
+    }
+    get status() {
+        if (this.isPending())
+            return "pending";
+        if (this.isRunning())
+            return "running";
+        if (this.isSuccess())
+            return "success";
+        if (this.isFailed())
+            return "failed";
+        return "unknown";
+    }
+    cancel() {
+        if (!this.isPending()) {
+            return false;
+        }
+        const error = new AppsScriptJobCancelledError();
+        this.fail(error);
+        return true;
+    }
+}
+exports.AppsScriptJob = AppsScriptJob;
+class AppsScriptJobCancelledError extends Error {
+    constructor() {
+        super("Job cancelled");
+        this.name = "AppsScriptJobCancelledError";
+    }
+}
+exports.AppsScriptJobCancelledError = AppsScriptJobCancelledError;

package/dist/AppsScriptJobQueue.d.ts

@@ -0,0 +1,14 @@
+import { AppsScriptJob } from "./AppsScriptJob";
+export interface RunnableJob {
+    run(): Promise<void>;
+    addJob<T>(job: AppsScriptJob<T>): void;
+}
+export declare class AppsScriptJobQueue {
+    private jobs;
+    private listeners;
+    enqueue<T>(label: string, execute: () => Promise<T>): Promise<T>;
+    dequeue(): AppsScriptJob<any> | undefined;
+    private notify;
+    subscribe(listener: RunnableJob): () => boolean;
+    remove(jobId: string): void;
+}

package/dist/AppsScriptJobQueue.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptJobQueue = void 0;
+const AppsScriptJob_1 = require("./AppsScriptJob");
+class AppsScriptJobQueue {
+    jobs = [];
+    listeners = new Set();
+    enqueue(label, execute) {
+        const promise = new Promise((resolve, reject) => {
+            // キューにジョブを追加
+            const job = new AppsScriptJob_1.AppsScriptJob(label, execute, resolve, reject);
+            this.jobs.push(job);
+            this.notify(job);
+        });
+        return promise;
+    }
+    dequeue() {
+        const job = this.jobs.shift();
+        if (!job)
+            return undefined;
+        return job;
+    }
+    notify(job) {
+        this.listeners.forEach((listener) => {
+            listener.addJob(job);
+            listener.run();
+        });
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    remove(jobId) {
+        const index = this.jobs.findIndex((job) => job.id === jobId);
+        if (index !== -1) {
+            this.jobs.splice(index, 1);
+        }
+    }
+}
+exports.AppsScriptJobQueue = AppsScriptJobQueue;

package/dist/AppsScriptJobRunner.d.ts

@@ -0,0 +1,20 @@
+import { AppsScriptJob } from "./AppsScriptJob";
+import { AppsScriptJobQueue, RunnableJob } from "./AppsScriptJobQueue";
+export declare class AppsScriptJobRunner implements RunnableJob {
+    readonly queue: AppsScriptJobQueue;
+    private jobs;
+    private listeners;
+    private MAX_CONCURRENT;
+    private running;
+    private snapshot;
+    private dirty;
+    constructor(queue: AppsScriptJobQueue);
+    addJob<T>(job: AppsScriptJob<T>): void;
+    getJobs(): AppsScriptJob<any>[];
+    run(): Promise<void>;
+    remove(jobId: string): void;
+    cancel(jobId: string): void;
+    retry(jobId: AppsScriptJob<any>["id"]): void;
+    subscribe(listener: () => void): () => boolean;
+    private notify;
+}

package/dist/AppsScriptJobRunner.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptJobRunner = void 0;
+class AppsScriptJobRunner {
+    queue;
+    jobs = [];
+    listeners = new Set();
+    MAX_CONCURRENT = 30;
+    running = false;
+    snapshot = null;
+    dirty = true;
+    constructor(queue) {
+        this.queue = queue;
+        this.queue.subscribe(this);
+    }
+    addJob(job) {
+        this.jobs.push(job);
+        this.notify();
+    }
+    getJobs() {
+        if (this.dirty || !this.snapshot) {
+            this.snapshot = [...this.jobs];
+            this.dirty = false;
+        }
+        return this.snapshot;
+    }
+    async run() {
+        if (this.running)
+            return;
+        this.running = true;
+        while (true) {
+            const runningCount = this.jobs.filter((j) => j.isRunning()).length;
+            if (runningCount >= this.MAX_CONCURRENT)
+                break;
+            const job = this.queue.dequeue();
+            if (!job)
+                break;
+            job.start();
+            this.notify();
+            job
+                .execute()
+                .then((result) => {
+                job.success(result);
+                const index = this.jobs.indexOf(job);
+                if (index !== -1) {
+                    this.jobs.splice(index, 1);
+                }
+            })
+                .catch((error) => {
+                job.fail(error);
+            })
+                .finally(() => {
+                this.notify();
+                this.running = false;
+                this.run();
+            });
+        }
+        this.running = false;
+    }
+    remove(jobId) {
+        const index = this.jobs.findIndex((job) => job.id === jobId);
+        if (index === -1) {
+            return;
+        }
+        this.jobs.splice(index, 1);
+        this.notify();
+    }
+    cancel(jobId) {
+        const job = this.jobs.find((job) => job.id === jobId);
+        if (!job || !job.cancel()) {
+            return;
+        }
+        this.queue.remove(jobId);
+        this.jobs.splice(this.jobs.indexOf(job), 1);
+        this.notify();
+    }
+    retry(jobId) {
+        const job = this.jobs.find((j) => j.id === jobId);
+        if (job) {
+            this.remove(job.id);
+            this.queue.enqueue(job.label, job.execute);
+        }
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        this.dirty = true;
+        this.listeners.forEach((listener) => listener());
+    }
+}
+exports.AppsScriptJobRunner = AppsScriptJobRunner;

package/dist/AppsScriptJobStore.d.ts

@@ -0,0 +1,7 @@
+import { AppsScriptJob } from "./AppsScriptJob";
+import { AppsScriptJobRunner } from "./AppsScriptJobRunner";
+export interface AppsScriptJobStore {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => AppsScriptJob<any>[];
+}
+export declare function appsScriptJobStore(runner: AppsScriptJobRunner): AppsScriptJobStore;

package/dist/AppsScriptJobStore.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appsScriptJobStore = appsScriptJobStore;
+function appsScriptJobStore(runner) {
+    return {
+        subscribe: runner.subscribe.bind(runner),
+        getSnapshot: runner.getJobs.bind(runner),
+    };
+}

package/dist/google.d.ts

@@ -0,0 +1,36 @@
+export type GoogleScriptRun = {
+    withSuccessHandler<T = unknown>(callback: (result: T) => void): GoogleScriptRun;
+    withFailureHandler(callback: (error: Error) => void): GoogleScriptRun;
+    [serverFunctionName: string]: any;
+};
+export type GoogleScriptHistoryEvent = {
+    state: Record<string, unknown>;
+    location: {
+        hash: string;
+        parameter: Record<string, string>;
+        parameters: Record<string, string[]>;
+    };
+};
+export type GoogleScriptUrlLocation = {
+    hash: string;
+    parameter: Record<string, string>;
+    parameters: Record<string, string[]>;
+};
+export type GoogleApi = {
+    script: {
+        run: GoogleScriptRun;
+        history: {
+            push: (stateObject: Record<string, unknown>, params: Record<string, unknown>, hash: string) => void;
+            replace: (stateObject: Record<string, unknown>, params: Record<string, unknown>, hash: string) => void;
+            setChangeHandler: (callback: (event: GoogleScriptHistoryEvent) => void) => void;
+        };
+        url: {
+            getLocation: (callback: (location: GoogleScriptUrlLocation) => void) => void;
+        };
+    };
+};
+/**
+ * google.script.* は Apps Script のランタイムが注入するグローバル。
+ * ここでは「型付きで参照」だけ提供する。
+ */
+export declare const google: GoogleApi;

package/dist/google.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.google = void 0;
+/**
+ * google.script.* は Apps Script のランタイムが注入するグローバル。
+ * ここでは「型付きで参照」だけ提供する。
+ */
+exports.google = globalThis.google;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { appsScriptClient } from "./AppsScriptClient";
+export type { AppsScriptJob } from "./job/AppsScriptJob";
+export { AppsScriptJobStore } from "./job/AppsScriptJobStore";
+export { AppsScriptHistoryPipeline } from "./navigation/AppsScriptHistoryPipeline";

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptHistoryPipeline = exports.appsScriptClient = void 0;
+var AppsScriptClient_1 = require("./AppsScriptClient");
+Object.defineProperty(exports, "appsScriptClient", { enumerable: true, get: function () { return AppsScriptClient_1.appsScriptClient; } });
+var AppsScriptHistoryPipeline_1 = require("./navigation/AppsScriptHistoryPipeline");
+Object.defineProperty(exports, "AppsScriptHistoryPipeline", { enumerable: true, get: function () { return AppsScriptHistoryPipeline_1.AppsScriptHistoryPipeline; } });

package/dist/job/AppsScriptJob.d.ts

@@ -0,0 +1,28 @@
+export declare class AppsScriptJob<T> {
+    readonly label: string;
+    readonly execute: () => Promise<T>;
+    private resolve;
+    private reject;
+    readonly id: string;
+    readonly createdAt: Date;
+    private _startedAt;
+    private _endedAt;
+    private _result;
+    private _error;
+    constructor(label: string, execute: () => Promise<T>, resolve: (value: T) => void, reject: (reason?: any) => void, id?: string, createdAt?: Date);
+    start(): void;
+    success(result: T): void;
+    fail(error: unknown): void;
+    get endedAt(): Date | null;
+    get result(): T | null;
+    get error(): unknown;
+    isPending(): boolean;
+    isRunning(): boolean;
+    isSuccess(): boolean;
+    isFailed(): boolean;
+    get status(): "failed" | "pending" | "running" | "success" | "unknown";
+    cancel(): boolean;
+}
+export declare class AppsScriptJobCancelledError extends Error {
+    constructor();
+}

package/dist/job/AppsScriptJob.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptJobCancelledError = exports.AppsScriptJob = void 0;
+class AppsScriptJob {
+    label;
+    execute;
+    resolve;
+    reject;
+    id;
+    createdAt;
+    _startedAt = null;
+    _endedAt = null;
+    _result = null;
+    _error = null;
+    constructor(label, execute, resolve, reject, id = crypto.randomUUID(), createdAt = new Date()) {
+        this.label = label;
+        this.execute = execute;
+        this.resolve = resolve;
+        this.reject = reject;
+        this.id = id;
+        this.createdAt = createdAt;
+    }
+    start() {
+        this._startedAt = new Date();
+    }
+    success(result) {
+        this._endedAt = new Date();
+        this._result = result;
+        this.resolve(result);
+    }
+    fail(error) {
+        this._endedAt = new Date();
+        this._error = error;
+        this.reject(error);
+    }
+    get endedAt() {
+        return this._endedAt;
+    }
+    get result() {
+        return this._result;
+    }
+    get error() {
+        return this._error;
+    }
+    isPending() {
+        return this._startedAt === null;
+    }
+    isRunning() {
+        return this._startedAt !== null && this._endedAt === null;
+    }
+    isSuccess() {
+        return this._endedAt !== null && this._error === null;
+    }
+    isFailed() {
+        return this._endedAt !== null && this._error !== null;
+    }
+    get status() {
+        if (this.isPending())
+            return "pending";
+        if (this.isRunning())
+            return "running";
+        if (this.isSuccess())
+            return "success";
+        if (this.isFailed())
+            return "failed";
+        return "unknown";
+    }
+    cancel() {
+        if (!this.isPending()) {
+            return false;
+        }
+        const error = new AppsScriptJobCancelledError();
+        this.fail(error);
+        return true;
+    }
+}
+exports.AppsScriptJob = AppsScriptJob;
+class AppsScriptJobCancelledError extends Error {
+    constructor() {
+        super("Job cancelled");
+        this.name = "AppsScriptJobCancelledError";
+    }
+}
+exports.AppsScriptJobCancelledError = AppsScriptJobCancelledError;

package/dist/job/AppsScriptJobQueue.d.ts

@@ -0,0 +1,14 @@
+import { AppsScriptJob } from "./AppsScriptJob";
+export interface RunnableJob {
+    run(): Promise<void>;
+    addJob<T>(job: AppsScriptJob<T>): void;
+}
+export declare class AppsScriptJobQueue {
+    private jobs;
+    private listeners;
+    enqueue<T>(label: string, execute: () => Promise<T>): Promise<T>;
+    dequeue(): AppsScriptJob<any> | undefined;
+    private notify;
+    subscribe(listener: RunnableJob): () => boolean;
+    remove(jobId: string): void;
+}

package/dist/job/AppsScriptJobQueue.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppsScriptJobQueue = void 0;
+const AppsScriptJob_1 = require("./AppsScriptJob");
+class AppsScriptJobQueue {
+    jobs = [];
+    listeners = new Set();
+    enqueue(label, execute) {
+        const promise = new Promise((resolve, reject) => {
+            // キューにジョブを追加
+            const job = new AppsScriptJob_1.AppsScriptJob(label, execute, resolve, reject);
+            this.jobs.push(job);
+            this.notify(job);
+        });
+        return promise;
+    }
+    dequeue() {
+        const job = this.jobs.shift();
+        if (!job)
+            return undefined;
+        return job;
+    }
+    notify(job) {
+        this.listeners.forEach((listener) => {
+            listener.addJob(job);
+            listener.run();
+        });
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    remove(jobId) {
+        const index = this.jobs.findIndex((job) => job.id === jobId);
+        if (index !== -1) {
+            this.jobs.splice(index, 1);
+        }
+    }
+}
+exports.AppsScriptJobQueue = AppsScriptJobQueue;

package/dist/job/AppsScriptJobRunner.d.ts

@@ -0,0 +1,20 @@
+import { AppsScriptJob } from "./AppsScriptJob";
+import { AppsScriptJobQueue, RunnableJob } from "./AppsScriptJobQueue";
+export declare class AppsScriptJobRunner implements RunnableJob {
+    readonly queue: AppsScriptJobQueue;
+    private jobs;
+    private listeners;
+    private MAX_CONCURRENT;
+    private running;
+    private snapshot;
+    private dirty;
+    constructor(queue: AppsScriptJobQueue);
+    addJob<T>(job: AppsScriptJob<T>): void;
+    getJobs(): AppsScriptJob<any>[];
+    run(): Promise<void>;
+    remove(jobId: string): void;
+    cancel(jobId: string): void;
+    retry(jobId: AppsScriptJob<any>["id"]): void;
+    subscribe(listener: () => void): () => boolean;
+    private notify;
+}