@gasboost/client 0.1.0 → 0.1.1

package/dist/AppsScriptJobRunner.js

@@ -1,93 +0,0 @@
-"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

@@ -1,7 +0,0 @@
-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

@@ -1,9 +0,0 @@
-"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/src/AppsScriptClient.ts

@@ -1,81 +0,0 @@
-import { google } from "./google";
-import { AppsScriptJob } from "./job/AppsScriptJob";
-import { AppsScriptJobQueue } from "./job/AppsScriptJobQueue";
-import { AppsScriptJobRunner } from "./job/AppsScriptJobRunner";
-import { appsScriptJobStore } from "./job/AppsScriptJobStore";
-
-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 const appsScriptTransport = {
-  call(name: string, args: unknown[]): Promise<RpcResponse> {
-    return new Promise((resolve, reject) => {
-      google.script.run
-        .withSuccessHandler(resolve)
-        .withFailureHandler(reject)
-        [name](...args);
-    });
-  },
-};
-
-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 function appsScriptClient<TApp extends RpcApp>(): {
-  client: AppsScriptClient<TApp>;
-  jobs: AppsScriptJobs;
-} {
-  const jobQueue = new AppsScriptJobQueue();
-  const jobRunner = new AppsScriptJobRunner(jobQueue);
-  const jobStore = appsScriptJobStore(jobRunner);
-
-  const client = new Proxy(
-    {},
-    {
-      get(_target, property) {
-        if (typeof property !== "string") {
-          return undefined;
-        }
-
-        return (...args: unknown[]) => {
-          return jobQueue.enqueue(property, async () => {
-            const res = await appsScriptTransport.call(property, args);
-            return JSON.parse(res.contents);
-          });
-        };
-      },
-    },
-  ) as AppsScriptClient<TApp>;
-
-  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/src/google.ts

@@ -1,55 +0,0 @@
-export type GoogleScriptRun = {
-  withSuccessHandler<T = unknown>(
-    callback: (result: T) => void,
-  ): GoogleScriptRun;
-  withFailureHandler(callback: (error: Error) => void): GoogleScriptRun;
-  // GAS は run.任意のサーバー関数名(...) を呼ぶので index signature を持たせる
-  [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 const google = (globalThis as any).google as GoogleApi;

package/src/index.ts

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

package/src/job/AppsScriptJob.ts

@@ -1,85 +0,0 @@
-export class AppsScriptJob<T> {
-  private _startedAt: Date | null = null;
-  private _endedAt: Date | null = null;
-  private _result: T | null = null;
-  private _error: unknown | null = null;
-
-  constructor(
-    public readonly label: string,
-    public readonly execute: () => Promise<T>,
-    private resolve: (value: T) => void,
-    private reject: (reason?: any) => void,
-    public readonly id: string = crypto.randomUUID(),
-    public readonly createdAt: Date = new Date(),
-  ) {}
-
-  start() {
-    this._startedAt = new Date();
-  }
-
-  success(result: T) {
-    this._endedAt = new Date();
-    this._result = result;
-    this.resolve(result);
-  }
-
-  fail(error: unknown) {
-    this._endedAt = new Date();
-    this._error = error;
-    this.reject(error);
-  }
-
-  public get endedAt() {
-    return this._endedAt;
-  }
-
-  public get result() {
-    return this._result;
-  }
-
-  public get error() {
-    return this._error;
-  }
-
-  public isPending() {
-    return this._startedAt === null;
-  }
-
-  public isRunning() {
-    return this._startedAt !== null && this._endedAt === null;
-  }
-
-  public isSuccess() {
-    return this._endedAt !== null && this._error === null;
-  }
-
-  public isFailed() {
-    return this._endedAt !== null && this._error !== null;
-  }
-
-  public get status() {
-    if (this.isPending()) return "pending";
-    if (this.isRunning()) return "running";
-    if (this.isSuccess()) return "success";
-    if (this.isFailed()) return "failed";
-    return "unknown";
-  }
-
-  public cancel(): boolean {
-    if (!this.isPending()) {
-      return false;
-    }
-
-    const error = new AppsScriptJobCancelledError();
-    this.fail(error);
-
-    return true;
-  }
-}
-
-export class AppsScriptJobCancelledError extends Error {
-  constructor() {
-    super("Job cancelled");
-    this.name = "AppsScriptJobCancelledError";
-  }
-}

package/src/job/AppsScriptJobQueue.ts

@@ -1,48 +0,0 @@
-import { AppsScriptJob } from "./AppsScriptJob";
-
-export interface RunnableJob {
-  run(): Promise<void>;
-  addJob<T>(job: AppsScriptJob<T>): void;
-}
-
-export class AppsScriptJobQueue {
-  private jobs: AppsScriptJob<any>[] = [];
-  private listeners: Set<RunnableJob> = new Set();
-
-  public enqueue<T>(label: string, execute: () => Promise<T>): Promise<T> {
-    const promise = new Promise<T>((resolve, reject) => {
-      // キューにジョブを追加
-      const job = new AppsScriptJob<T>(label, execute, resolve, reject);
-      this.jobs.push(job);
-      this.notify(job);
-    });
-
-    return promise;
-  }
-
-  public dequeue(): AppsScriptJob<any> | undefined {
-    const job = this.jobs.shift();
-    if (!job) return undefined;
-    return job;
-  }
-
-  private notify<T>(job: AppsScriptJob<T>) {
-    this.listeners.forEach((listener) => {
-      listener.addJob(job);
-      listener.run();
-    });
-  }
-
-  public subscribe(listener: RunnableJob) {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  remove(jobId: string) {
-    const index = this.jobs.findIndex((job) => job.id === jobId);
-
-    if (index !== -1) {
-      this.jobs.splice(index, 1);
-    }
-  }
-}

package/src/job/AppsScriptJobRunner.ts

@@ -1,107 +0,0 @@
-import { AppsScriptJob } from "./AppsScriptJob";
-import { AppsScriptJobQueue, RunnableJob } from "./AppsScriptJobQueue";
-
-export class AppsScriptJobRunner implements RunnableJob {
-  private jobs: AppsScriptJob<any>[] = [];
-  private listeners: Set<() => void> = new Set();
-  private MAX_CONCURRENT = 30;
-  private running = false;
-
-  private snapshot: AppsScriptJob<any>[] | null = null;
-  private dirty = true;
-
-  constructor(public readonly queue: AppsScriptJobQueue) {
-    this.queue.subscribe(this);
-  }
-
-  public addJob<T>(job: AppsScriptJob<T>) {
-    this.jobs.push(job);
-    this.notify();
-  }
-
-  public getJobs() {
-    if (this.dirty || !this.snapshot) {
-      this.snapshot = [...this.jobs];
-      this.dirty = false;
-    }
-    return this.snapshot;
-  }
-
-  public async run(): Promise<void> {
-    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;
-  }
-
-  public remove(jobId: string) {
-    const index = this.jobs.findIndex((job) => job.id === jobId);
-
-    if (index === -1) {
-      return;
-    }
-
-    this.jobs.splice(index, 1);
-    this.notify();
-  }
-
-  public cancel(jobId: string) {
-    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();
-  }
-
-  public retry(jobId: AppsScriptJob<any>["id"]) {
-    const job = this.jobs.find((j) => j.id === jobId);
-    if (job) {
-      this.remove(job.id);
-      this.queue.enqueue(job.label, job.execute);
-    }
-  }
-
-  public subscribe(listener: () => void) {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  private notify() {
-    this.dirty = true;
-    this.listeners.forEach((listener) => listener());
-  }
-}

package/src/job/AppsScriptJobStore.ts

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

package/src/navigation/AppsScriptContainer.ts

@@ -1,47 +0,0 @@
-import { google } from "../google";
-
-import { NavigationEntry } from "./NavigationEntry";
-
-export class AppsScriptContainer {
-  private constructor(private entry: NavigationEntry) {}
-
-  static load(callback: (container: AppsScriptContainer) => void) {
-    google.script.url.getLocation((location) => {
-      callback(new AppsScriptContainer(NavigationEntry.fromGoogle(location)));
-    });
-  }
-
-  observe(handler: (entry: NavigationEntry) => void) {
-    google.script.history.setChangeHandler((event) => {
-      const entry = NavigationEntry.fromGoogle(event);
-
-      this.entry = entry;
-
-      handler(entry);
-    });
-  }
-
-  sync(entry: NavigationEntry) {
-    if (this.entry.equals(entry)) {
-      return;
-    }
-
-    this.entry = entry;
-
-    const parameters: Record<string, string[]> = {};
-
-    for (const key of new Set(entry.location.searchParams.keys())) {
-      parameters[key] = entry.location.searchParams.getAll(key);
-    }
-
-    google.script.history.push(
-      entry.state,
-      parameters,
-      entry.location.hash.normalize(),
-    );
-  }
-
-  current() {
-    return this.entry;
-  }
-}

package/src/navigation/AppsScriptHistoryPipeline.ts

@@ -1,29 +0,0 @@
-import { AppsScriptContainer } from "./AppsScriptContainer";
-import { AppsScriptIframe } from "./AppsScriptIframe";
-
-export class AppsScriptHistoryPipeline {
-  constructor(
-    private readonly container: AppsScriptContainer,
-    private readonly iframe: AppsScriptIframe,
-  ) {}
-
-  static create(callback: (pipeline: AppsScriptHistoryPipeline) => void) {
-    AppsScriptContainer.load((container) => {
-      callback(
-        new AppsScriptHistoryPipeline(container, new AppsScriptIframe()),
-      );
-    });
-  }
-
-  sync() {
-    this.iframe.sync(this.container.current());
-
-    this.container.observe((entry) => {
-      this.iframe.sync(entry);
-    });
-
-    return this.iframe.observe((entry) => {
-      this.container.sync(entry);
-    });
-  }
-}

package/src/navigation/AppsScriptIframe.ts

@@ -1,63 +0,0 @@
-import { HashProperty } from "./HashProperty";
-import { NavigationEntry } from "./NavigationEntry";
-import { NavigationLocation } from "./NavigationLocation";
-
-export class AppsScriptIframe {
-  private entry: NavigationEntry;
-
-  constructor() {
-    this.entry = this.read();
-  }
-
-  observe(handler: (entry: NavigationEntry) => void) {
-    const listener = () => {
-      const entry = this.read();
-
-      this.entry = entry;
-
-      handler(entry);
-    };
-
-    window.addEventListener("hashchange", listener);
-    window.addEventListener("popstate", listener);
-
-    return () => {
-      window.removeEventListener("hashchange", listener);
-      window.removeEventListener("popstate", listener);
-    };
-  }
-
-  sync(entry: NavigationEntry) {
-    if (this.entry.equals(entry)) {
-      return;
-    }
-
-    const hash = entry.location.hash.normalize();
-    const search = entry.location.searchParams.toString();
-    const nextHash = search ? `${hash}?${search}` : hash;
-
-    history.replaceState(entry.state, "", nextHash);
-
-    this.entry = entry;
-  }
-
-  current() {
-    return this.entry;
-  }
-
-  private read() {
-    const normalized = new HashProperty(window.location.hash)
-      .toString()
-      .replace(/^#/, "");
-
-    const [path = "/", query = ""] = normalized.split("?");
-
-    return new NavigationEntry(
-      history.state ?? {},
-      new NavigationLocation(
-        new HashProperty(path),
-        new URLSearchParams(query),
-      ),
-    );
-  }
-}

package/src/navigation/HashProperty.ts

@@ -1,20 +0,0 @@
-export class HashProperty {
-  constructor(private readonly value: string) {}
-
-  normalize() {
-    if (!this.value) return "#/";
-    if (this.value.startsWith("#/")) return this.value;
-    if (this.value.startsWith("#")) return `#/${this.value.slice(1)}`;
-    if (this.value.startsWith("/")) return `#${this.value}`;
-
-    return `#/${this.value}`;
-  }
-
-  equals(other: HashProperty) {
-    return this.normalize() === other.normalize();
-  }
-
-  toString() {
-    return this.normalize();
-  }
-}