@diskd-ai/sdk 5.1.2

package/dist/drive/DriveRepository.d.ts

@@ -0,0 +1,88 @@
+import type { DriveDbClient, DriveDbSchema, DriveDbType } from './driveDbTypes.js';
+export type WhereClause = {
+    readonly [column: string]: unknown;
+};
+export type OrderByClause = {
+    readonly column: string;
+    readonly direction?: 'ASC' | 'DESC';
+};
+export type FindOptions = {
+    readonly where?: WhereClause;
+    readonly orderBy?: OrderByClause | readonly OrderByClause[];
+    readonly limit?: number;
+    readonly offset?: number;
+};
+export type UpdateOptions = {
+    readonly where: WhereClause;
+    readonly set: Readonly<Record<string, unknown>>;
+};
+export type DriveRepository = {
+    /** Table name this repository operates on. */
+    readonly table: string;
+    /** Insert one or more rows. */
+    readonly insert: (rows: readonly Readonly<Record<string, unknown>>[]) => Promise<{
+        readonly inserted: number;
+    }>;
+    /** Find rows matching criteria. */
+    readonly find: (options?: FindOptions) => Promise<readonly Readonly<Record<string, unknown>>[]>;
+    /** Find a single row matching criteria, or null. */
+    readonly findOne: (where: WhereClause) => Promise<Readonly<Record<string, unknown>> | null>;
+    /** Count rows matching criteria. */
+    readonly count: (where?: WhereClause) => Promise<number>;
+    /** Update rows matching criteria. */
+    readonly update: (options: UpdateOptions) => Promise<void>;
+    /** Delete rows matching criteria. */
+    readonly deleteRows: (where: WhereClause) => Promise<void>;
+};
+export type DriveDatabaseParams = {
+    readonly dbName: string;
+    readonly dbType?: DriveDbType;
+    readonly schema?: DriveDbSchema;
+};
+export type DriveDatabaseConfig = {
+    readonly db: DriveDbClient;
+    readonly dbName: string;
+    readonly dbType?: DriveDbType;
+    readonly schema?: DriveDbSchema;
+};
+export type DriveDatabase = {
+    /** Database name. */
+    readonly dbName: string;
+    /** Create the database (idempotent -- checkExists: true). */
+    readonly ensureCreated: () => Promise<{
+        readonly dbInode: string;
+        readonly fileId: string;
+    }>;
+    /** Recreate the database (drops if exists). */
+    readonly recreate: () => Promise<{
+        readonly dbInode: string;
+        readonly fileId: string;
+    }>;
+    /** Get a table-scoped repository with CRUD operations. */
+    readonly repository: (table: string) => DriveRepository;
+    /** Execute a raw SQL query with optional parameters. */
+    readonly query: (sql: string, parameters?: readonly unknown[]) => Promise<readonly Readonly<Record<string, unknown>>[]>;
+    /** Commit pending changes (flush WAL to S3). */
+    readonly commit: () => Promise<{
+        readonly commitId: string;
+    }>;
+    /** Rollback uncommitted changes (discard WAL, revert to last commit). */
+    readonly rollback: () => Promise<void>;
+    /** Get database metadata. */
+    readonly metadata: () => Promise<{
+        readonly inode: string;
+        readonly displayName: string;
+        readonly recordCount: number;
+        readonly sizeBytes: number;
+    }>;
+    /** Set external processing status. */
+    readonly setStatus: (status: string, error?: string) => Promise<void>;
+    /** Drop the database entirely. */
+    readonly drop: () => Promise<{
+        readonly deletedFromMetadata: boolean;
+    }>;
+    /** Access the underlying DriveDbClient for advanced operations. */
+    readonly raw: DriveDbClient;
+};
+export declare const createDriveDatabase: (config: DriveDatabaseConfig) => DriveDatabase;
+//# sourceMappingURL=DriveRepository.d.ts.map

package/dist/drive/DriveRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriveRepository.d.ts","sourceRoot":"","sources":["../../src/drive/DriveRepository.ts"],"names":[],"mappings":"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"}

package/dist/drive/DriveRepository.js

@@ -0,0 +1,156 @@
+// ---------------------------------------------------------------------------
+// DriveDatabase + DriveRepository
+// ---------------------------------------------------------------------------
+//
+// DriveDatabase -- database lifecycle (create, commit, drop, raw SQL, metadata)
+// DriveRepository -- table-scoped CRUD (insert, find, findOne, count, update, delete)
+//
+// Usage:
+//   const db = diskd.os.database({
+//     auth,
+//     dbName: 'shop.workspace-123.main',
+//     schema: {
+//       users:  { id: { type: 'TEXT', primaryKey: true }, name: { type: 'TEXT', notNull: true } },
+//       orders: { id: { type: 'TEXT', primaryKey: true }, user_id: { type: 'TEXT' } },
+//     },
+//   });
+//
+//   await db.ensureCreated();
+//
+//   const users = db.repository('users');
+//   await users.insert([{ id: 'u1', name: 'Alice' }]);
+//   const alice = await users.findOne({ id: 'u1' });
+//
+//   await db.commit();
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// SQL builder helpers (pure functions)
+// ---------------------------------------------------------------------------
+const buildWhereClause = (where) => {
+    const keys = Object.keys(where);
+    if (keys.length === 0)
+        return { sql: '', params: [] };
+    const conditions = [];
+    const params = [];
+    for (const key of keys) {
+        const value = where[key];
+        if (value === null) {
+            conditions.push(`${key} IS NULL`);
+        }
+        else {
+            conditions.push(`${key} = ?`);
+            params.push(value);
+        }
+    }
+    return { sql: ` WHERE ${conditions.join(' AND ')}`, params };
+};
+const buildOrderByClause = (orderBy) => {
+    const clauses = Array.isArray(orderBy) ? orderBy : [orderBy];
+    if (clauses.length === 0)
+        return '';
+    const parts = clauses.map((c) => `${c.column} ${c.direction ?? 'ASC'}`);
+    return ` ORDER BY ${parts.join(', ')}`;
+};
+const buildLimitOffset = (limit, offset) => {
+    let sql = '';
+    if (limit !== undefined)
+        sql += ` LIMIT ${limit}`;
+    if (offset !== undefined)
+        sql += ` OFFSET ${offset}`;
+    return sql;
+};
+// ---------------------------------------------------------------------------
+// Repository factory (table-scoped)
+// ---------------------------------------------------------------------------
+const createRepository = (deps) => {
+    const { table, db, dbName, dbType, execQuery } = deps;
+    return {
+        table,
+        insert: async (rows) => {
+            const result = await db.insert({ name: dbName, table, rows, dbType });
+            return { inserted: result.inserted };
+        },
+        find: async (options) => {
+            const { where, orderBy, limit, offset } = options ?? {};
+            const w = where ? buildWhereClause(where) : { sql: '', params: [] };
+            const sql = `SELECT * FROM ${table}${w.sql}${orderBy ? buildOrderByClause(orderBy) : ''}${buildLimitOffset(limit, offset)}`;
+            return execQuery(sql, w.params.length > 0 ? w.params : undefined);
+        },
+        findOne: async (where) => {
+            const w = buildWhereClause(where);
+            const sql = `SELECT * FROM ${table}${w.sql} LIMIT 1`;
+            const rows = await execQuery(sql, w.params.length > 0 ? w.params : undefined);
+            return rows.length > 0 ? rows[0] : null;
+        },
+        count: async (where) => {
+            const w = where ? buildWhereClause(where) : { sql: '', params: [] };
+            const sql = `SELECT COUNT(*) AS cnt FROM ${table}${w.sql}`;
+            const rows = await execQuery(sql, w.params.length > 0 ? w.params : undefined);
+            return Number(rows[0]?.cnt ?? 0);
+        },
+        update: async (options) => {
+            const { where, set } = options;
+            const setCols = Object.keys(set);
+            if (setCols.length === 0)
+                return;
+            const setParts = setCols.map((col) => `${col} = ?`);
+            const setParams = setCols.map((col) => set[col]);
+            const w = buildWhereClause(where);
+            const sql = `UPDATE ${table} SET ${setParts.join(', ')}${w.sql}`;
+            await execQuery(sql, [...setParams, ...w.params]);
+        },
+        deleteRows: async (where) => {
+            const w = buildWhereClause(where);
+            const sql = `DELETE FROM ${table}${w.sql}`;
+            await execQuery(sql, w.params.length > 0 ? w.params : undefined);
+        },
+    };
+};
+// ---------------------------------------------------------------------------
+// Database factory
+// ---------------------------------------------------------------------------
+export const createDriveDatabase = (config) => {
+    const { db, dbName, dbType, schema } = config;
+    const execQuery = async (sql, parameters) => {
+        const result = await db.query({ name: dbName, sql, parameters, dbType });
+        return result.rows;
+    };
+    return {
+        dbName,
+        ensureCreated: async () => {
+            const result = await db.create({ name: dbName, schema, checkExists: true, dbType });
+            return { dbInode: result.dbInode, fileId: result.fileId };
+        },
+        recreate: async () => {
+            const result = await db.create({ name: dbName, schema, recreate: true, dbType });
+            return { dbInode: result.dbInode, fileId: result.fileId };
+        },
+        repository: (table) => createRepository({ table, dbName, dbType, db, execQuery }),
+        query: execQuery,
+        commit: async () => {
+            const result = await db.commit({ name: dbName, dbType });
+            return { commitId: result.commitId };
+        },
+        rollback: async () => {
+            await db.rollback({ name: dbName, dbType });
+        },
+        metadata: async () => {
+            const result = await db.metadata({ name: dbName, dbType });
+            return {
+                inode: result.inode,
+                displayName: result.displayName,
+                recordCount: result.recordCount,
+                sizeBytes: result.sizeBytes,
+            };
+        },
+        setStatus: async (status, error) => {
+            await db.setStatus({ name: dbName, status, error, dbType });
+        },
+        drop: async () => {
+            const result = await db.drop({ name: dbName, dbType });
+            return { deletedFromMetadata: result.deletedFromMetadata };
+        },
+        raw: db,
+    };
+};
+//# sourceMappingURL=DriveRepository.js.map

package/dist/drive/DriveRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DriveRepository.js","sourceRoot":"","sources":["../../src/drive/DriveRepository.ts"],"names":[],"mappings":"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"}

package/dist/drive/crontab.d.ts

@@ -0,0 +1,7 @@
+import type { DriveCrontabClient } from './crontabTypes.js';
+type RpcCall = (method: string, rpcParams: unknown) => Promise<unknown>;
+export declare const createDriveCrontabClient: (params: {
+    readonly call: RpcCall;
+}) => DriveCrontabClient;
+export {};
+//# sourceMappingURL=crontab.d.ts.map

package/dist/drive/crontab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crontab.d.ts","sourceRoot":"","sources":["../../src/drive/crontab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAuBnB,MAAM,mBAAmB,CAAC;AAG3B,KAAK,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AA2WxE,eAAO,MAAM,wBAAwB,GAAI,QAAQ;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,KAAG,kBAsGH,CAAC"}

package/dist/drive/crontab.js

@@ -0,0 +1,374 @@
+const HTTP_METHODS = new Set(['DELETE', 'GET', 'POST', 'PUT']);
+const PAYLOAD_KINDS = new Set(['json', 'path', 'uri']);
+const isObject = (value) => typeof value === 'object' && value !== null;
+const hasOwn = (obj, key) => Object.hasOwn(obj, key);
+const readField = (obj, snakeKey, camelKey) => hasOwn(obj, snakeKey) ? obj[snakeKey] : obj[camelKey];
+const readRequiredNonEmptyString = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a non-empty string`);
+    }
+    return value;
+};
+const readNullableString = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a string or null`);
+    }
+    return value;
+};
+const readNullableNumber = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== 'number') {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a number or null`);
+    }
+    return value;
+};
+const readRequiredNumber = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (typeof value !== 'number') {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a number`);
+    }
+    return value;
+};
+const readRequiredBoolean = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (typeof value !== 'boolean') {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a boolean`);
+    }
+    return value;
+};
+const readRequiredArray = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (!Array.isArray(value)) {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be an array`);
+    }
+    return value;
+};
+const readRequiredHttpMethod = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (typeof value !== 'string' || !HTTP_METHODS.has(value)) {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a supported HTTP method`);
+    }
+    return value;
+};
+const readRequiredPayloadKind = (obj, snakeKey, camelKey) => {
+    const value = readField(obj, snakeKey, camelKey);
+    if (typeof value !== 'string' || !PAYLOAD_KINDS.has(value)) {
+        throw new Error(`Invalid Drive crontab payload: '${snakeKey}' must be a supported payload kind`);
+    }
+    return value;
+};
+const tryParseJsonObject = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        return isObject(parsed) && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+};
+const isCrontabNotFoundError = (error) => {
+    if (!(error instanceof Error))
+        return false;
+    const jsonStart = error.message.indexOf('{');
+    if (jsonStart < 0)
+        return false;
+    const payload = tryParseJsonObject(error.message.slice(jsonStart));
+    if (!payload)
+        return false;
+    const data = payload.data;
+    if (!isObject(data) || Array.isArray(data))
+        return false;
+    return data.domain_code === 'CRONTAB_NOT_FOUND';
+};
+const decodeSchedule = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid Drive crontab schedule: expected object');
+    }
+    return {
+        minute: readRequiredNonEmptyString(raw, 'minute', 'minute'),
+        hour: readRequiredNonEmptyString(raw, 'hour', 'hour'),
+        dayOfMonth: readRequiredNonEmptyString(raw, 'day_of_month', 'dayOfMonth'),
+        month: readRequiredNonEmptyString(raw, 'month', 'month'),
+        dayOfWeek: readRequiredNonEmptyString(raw, 'day_of_week', 'dayOfWeek'),
+    };
+};
+const encodeSchedule = (schedule) => ({
+    minute: schedule.minute,
+    hour: schedule.hour,
+    day_of_month: schedule.dayOfMonth,
+    month: schedule.month,
+    day_of_week: schedule.dayOfWeek,
+});
+const decodePayload = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid Drive crontab payload: expected object');
+    }
+    const kind = readRequiredPayloadKind(raw, 'kind', 'kind');
+    if (kind === 'json') {
+        const value = readField(raw, 'value', 'value');
+        if (!isObject(value) && !Array.isArray(value)) {
+            throw new Error("Invalid Drive crontab payload: 'value' must be an object or array");
+        }
+        return {
+            kind: 'json',
+            value: value,
+        };
+    }
+    if (kind === 'path') {
+        return {
+            kind: 'path',
+            path: readRequiredNonEmptyString(raw, 'path', 'path'),
+        };
+    }
+    return {
+        kind: 'uri',
+        uri: readRequiredNonEmptyString(raw, 'uri', 'uri'),
+    };
+};
+const encodePayload = (payload) => {
+    if (payload.kind === 'json') {
+        return {
+            kind: 'json',
+            value: payload.value,
+        };
+    }
+    if (payload.kind === 'path') {
+        return {
+            kind: 'path',
+            path: payload.path,
+        };
+    }
+    return {
+        kind: 'uri',
+        uri: payload.uri,
+    };
+};
+const decodeRequest = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid Drive crontab request: expected object');
+    }
+    const payloadRaw = readField(raw, 'payload', 'payload');
+    return {
+        method: readRequiredHttpMethod(raw, 'method', 'method'),
+        url: readRequiredNonEmptyString(raw, 'url', 'url'),
+        payload: payloadRaw === undefined || payloadRaw === null ? null : decodePayload(payloadRaw),
+    };
+};
+const encodeRequest = (request) => ({
+    method: request.method,
+    url: request.url,
+    ...(request.payload !== null ? { payload: encodePayload(request.payload) } : {}),
+});
+const decodeJob = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid Drive crontab job: expected object');
+    }
+    const scheduleRaw = readField(raw, 'schedule', 'schedule');
+    const signalSubject = readNullableString(raw, 'signal_subject', 'signalSubject');
+    return {
+        jobId: readRequiredNonEmptyString(raw, 'job_id', 'jobId'),
+        enabled: readRequiredBoolean(raw, 'enabled', 'enabled'),
+        ...(scheduleRaw !== undefined && scheduleRaw !== null
+            ? { schedule: decodeSchedule(scheduleRaw) }
+            : {}),
+        ...(signalSubject !== null ? { signalSubject } : {}),
+        request: decodeRequest(readField(raw, 'request', 'request')),
+    };
+};
+const encodeJob = (job) => ({
+    job_id: job.jobId,
+    enabled: job.enabled,
+    ...(job.schedule !== undefined ? { schedule: encodeSchedule(job.schedule) } : {}),
+    ...(job.signalSubject !== undefined ? { signal_subject: job.signalSubject } : {}),
+    request: encodeRequest(job.request),
+});
+const decodeDocument = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid Drive crontab document: expected object');
+    }
+    const version = readRequiredNumber(raw, 'version', 'version');
+    if (version !== 1) {
+        throw new Error("Invalid Drive crontab document: 'version' must be 1");
+    }
+    return {
+        version,
+        timezone: readNullableString(raw, 'timezone', 'timezone'),
+        jobs: readRequiredArray(raw, 'jobs', 'jobs').map(decodeJob),
+    };
+};
+const encodeDocument = (document) => ({
+    version: document.version,
+    timezone: document.timezone,
+    jobs: document.jobs.map(encodeJob),
+});
+const encodeScope = (scope) => {
+    if (scope.scopeType === 'workspace') {
+        return { scope_type: 'workspace' };
+    }
+    return {
+        scope_type: 'project',
+        project_id: scope.projectId,
+    };
+};
+const upsertJob = (jobs, job) => {
+    const existingIndex = jobs.findIndex((item) => item.jobId === job.jobId);
+    if (existingIndex < 0) {
+        return [...jobs, job];
+    }
+    return jobs.map((item, index) => (index === existingIndex ? job : item));
+};
+const decodeSaveResult = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw))
+        throw new Error('Invalid drive/crontab/save result');
+    return {
+        jobCount: readRequiredNumber(raw, 'job_count', 'jobCount'),
+        nextRunAt: readNullableString(raw, 'next_run_at', 'nextRunAt'),
+        updatedAt: readRequiredNonEmptyString(raw, 'updated_at', 'updatedAt'),
+    };
+};
+const decodeGetResult = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw))
+        throw new Error('Invalid drive/crontab/get result');
+    return {
+        document: decodeDocument(readField(raw, 'document', 'document')),
+        jobCount: readRequiredNumber(raw, 'job_count', 'jobCount'),
+        nextRunAt: readNullableString(raw, 'next_run_at', 'nextRunAt'),
+        updatedAt: readRequiredNonEmptyString(raw, 'updated_at', 'updatedAt'),
+    };
+};
+const decodeGetStatusResult = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw))
+        throw new Error('Invalid drive/crontab/get-status result');
+    return {
+        jobCount: readRequiredNumber(raw, 'job_count', 'jobCount'),
+        nextRunAt: readNullableString(raw, 'next_run_at', 'nextRunAt'),
+        updatedAt: readRequiredNonEmptyString(raw, 'updated_at', 'updatedAt'),
+    };
+};
+const decodeListJobItem = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw)) {
+        throw new Error('Invalid drive/crontab/list-jobs item');
+    }
+    const scheduleRaw = readField(raw, 'schedule', 'schedule');
+    const signalSubject = readNullableString(raw, 'signal_subject', 'signalSubject');
+    const nextRunAt = readNullableString(raw, 'next_run_at', 'nextRunAt');
+    return {
+        jobId: readRequiredNonEmptyString(raw, 'job_id', 'jobId'),
+        enabled: readRequiredBoolean(raw, 'enabled', 'enabled'),
+        ...(scheduleRaw !== undefined && scheduleRaw !== null
+            ? { schedule: decodeSchedule(scheduleRaw) }
+            : {}),
+        ...(signalSubject !== null ? { signalSubject } : {}),
+        method: readRequiredHttpMethod(raw, 'method', 'method'),
+        url: readRequiredNonEmptyString(raw, 'url', 'url'),
+        payloadSource: readRequiredPayloadKind(raw, 'payload_source', 'payloadSource'),
+        ...(nextRunAt !== null ? { nextRunAt } : {}),
+        lastRunAt: readNullableString(raw, 'last_run_at', 'lastRunAt'),
+        lastHttpStatus: readNullableNumber(raw, 'last_http_status', 'lastHttpStatus'),
+        lastErrorSummary: readNullableString(raw, 'last_error_summary', 'lastErrorSummary'),
+    };
+};
+const decodeListJobsResult = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw))
+        throw new Error('Invalid drive/crontab/list-jobs result');
+    return {
+        items: readRequiredArray(raw, 'items', 'items').map(decodeListJobItem),
+    };
+};
+const decodeRunJobResult = (raw) => {
+    if (!isObject(raw) || Array.isArray(raw))
+        throw new Error('Invalid drive/crontab/run-job result');
+    return {
+        jobId: readRequiredNonEmptyString(raw, 'job_id', 'jobId'),
+        executedAt: readRequiredNonEmptyString(raw, 'executed_at', 'executedAt'),
+        lastHttpStatus: readNullableNumber(raw, 'last_http_status', 'lastHttpStatus'),
+        lastErrorSummary: readNullableString(raw, 'last_error_summary', 'lastErrorSummary'),
+    };
+};
+export const createDriveCrontabClient = (params) => {
+    const save = async (clientParams) => {
+        const result = await params.call('drive/crontab/save', {
+            scope: encodeScope(clientParams.scope),
+            document: encodeDocument(clientParams.document),
+        });
+        return decodeSaveResult(result);
+    };
+    const get = async (clientParams) => {
+        const result = await params.call('drive/crontab/get', {
+            scope: encodeScope(clientParams.scope),
+        });
+        return decodeGetResult(result);
+    };
+    const saveSingleJob = async (paramsForJob) => {
+        let currentDocument = null;
+        try {
+            currentDocument = (await get({ scope: paramsForJob.scope })).document;
+        }
+        catch (error) {
+            if (!isCrontabNotFoundError(error)) {
+                throw error;
+            }
+        }
+        const nextDocument = currentDocument ?? {
+            version: 1,
+            timezone: paramsForJob.timezone ?? null,
+            jobs: [],
+        };
+        return save({
+            scope: paramsForJob.scope,
+            document: {
+                version: nextDocument.version,
+                timezone: paramsForJob.timezone !== undefined ? paramsForJob.timezone : nextDocument.timezone,
+                jobs: upsertJob(nextDocument.jobs, paramsForJob.job),
+            },
+        });
+    };
+    return {
+        save,
+        get,
+        getStatus: async (clientParams) => {
+            const result = await params.call('drive/crontab/get-status', {
+                scope: encodeScope(clientParams.scope),
+            });
+            return decodeGetStatusResult(result);
+        },
+        createProjectJob: async (clientParams) => {
+            return saveSingleJob({
+                scope: {
+                    scopeType: 'project',
+                    projectId: clientParams.projectId,
+                },
+                job: clientParams.job,
+                timezone: clientParams.timezone,
+            });
+        },
+        createWorkspaceJob: async (clientParams) => {
+            return saveSingleJob({
+                scope: {
+                    scopeType: 'workspace',
+                },
+                job: clientParams.job,
+                timezone: clientParams.timezone,
+            });
+        },
+        listJobs: async (clientParams) => {
+            const result = await params.call('drive/crontab/list-jobs', {
+                scope: encodeScope(clientParams.scope),
+            });
+            return decodeListJobsResult(result);
+        },
+        runJob: async (clientParams) => {
+            const result = await params.call('drive/crontab/run-job', {
+                job_id: clientParams.jobId,
+            });
+            return decodeRunJobResult(result);
+        },
+    };
+};
+//# sourceMappingURL=crontab.js.map