syncsnap 1.0.0

package/README.md

@@ -0,0 +1,7 @@
+# syncsnap
+
+Syncsnap server SDK for Node and Next.js — API client and route handlers for file sync.
+
+## Docs
+
+**[Documentation →](https://docs.syncsnap.com)**

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+type JobStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+interface Job {
+    id: string;
+    projectId: string;
+    status: JobStatus;
+    fileName?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateJobResponse {
+    id: string;
+    projectId: string;
+    status: JobStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PresignedUrlResponse {
+    url: string;
+    fileName: string;
+    expiration: string;
+}
+/**
+ * Response for the download URL endpoint. When the server is configured with
+ * `onCompleted`, its return value is included as `completedPayload`.
+ */
+interface DownloadUrlResponse<T = unknown> extends PresignedUrlResponse {
+    completedPayload?: T;
+}
+interface WaitForJobOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    onPoll?: (job: Job) => void;
+    signal?: AbortSignal;
+}
+/** Response from the wait-for-completion endpoint. `result` is whatever the server's onCompleted callback returned. */
+interface WaitCompletionResponse<T = unknown> {
+    job: Job;
+    result?: T;
+}
+
+declare class SyncsnapServer {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetcher;
+    constructor(apiVersion?: string);
+    private authHeaders;
+    private requestJson;
+    createJob(): Promise<CreateJobResponse>;
+    getJob(jobId: string): Promise<Job>;
+    getUploadUrl(jobId: string, options: {
+        fileName: string;
+        expirationMinutes?: number;
+    }): Promise<PresignedUrlResponse>;
+    getDownloadUrl(jobId: string, options?: {
+        expirationMinutes?: number;
+    }): Promise<PresignedUrlResponse>;
+    waitForJobCompletion(jobId: string, options?: WaitForJobOptions): Promise<Job>;
+}
+
+export { type CreateJobResponse, type DownloadUrlResponse, type Job, type JobStatus, type PresignedUrlResponse, SyncsnapServer, type WaitCompletionResponse, type WaitForJobOptions };

package/dist/index.js

@@ -0,0 +1,86 @@
+// src/client.ts
+var SYNCSNAP_API_BASE_URL = "https://api.syncsnap.xyz/api";
+var SyncsnapServer = class {
+  constructor(apiVersion = "v1") {
+    this.baseUrl = `${SYNCSNAP_API_BASE_URL}/${apiVersion}`;
+    this.token = process.env.SYNCSNAP_TOKEN;
+    this.fetcher = fetch;
+  }
+  authHeaders() {
+    return {
+      "Content-Type": "application/json",
+      "X-API-KEY": this.token
+    };
+  }
+  async requestJson(url, init) {
+    const res = await this.fetcher(url, init);
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      const message = typeof data === "object" && data && "error" in data && data.error ? String(data.error) : `Syncsnap request failed (${res.status})`;
+      throw new Error(message);
+    }
+    return data;
+  }
+  async createJob() {
+    const url = `${this.baseUrl}/jobs`;
+    return this.requestJson(url, {
+      method: "POST",
+      headers: this.authHeaders()
+    });
+  }
+  async getJob(jobId) {
+    const url = `${this.baseUrl}/jobs/${encodeURIComponent(jobId)}`;
+    return this.requestJson(url, {
+      method: "GET",
+      headers: this.authHeaders()
+    });
+  }
+  async getUploadUrl(jobId, options) {
+    const url = `${this.baseUrl}/jobs/${encodeURIComponent(
+      jobId
+    )}/presigned-upload-url`;
+    return this.requestJson(url, {
+      method: "POST",
+      headers: this.authHeaders(),
+      body: JSON.stringify({
+        file_name: options.fileName,
+        expiration: options.expirationMinutes
+      })
+    });
+  }
+  async getDownloadUrl(jobId, options) {
+    const url = `${this.baseUrl}/jobs/${encodeURIComponent(
+      jobId
+    )}/presigned-download-url`;
+    return this.requestJson(url, {
+      method: "POST",
+      headers: this.authHeaders(),
+      body: JSON.stringify({
+        expiration: options?.expirationMinutes
+      })
+    });
+  }
+  async waitForJobCompletion(jobId, options = {}) {
+    const intervalMs = options.intervalMs ?? 2e3;
+    const timeoutMs = options.timeoutMs ?? 12e4;
+    const startedAt = Date.now();
+    while (true) {
+      if (options.signal?.aborted) {
+        throw new Error("Polling aborted");
+      }
+      if (Date.now() - startedAt > timeoutMs) {
+        throw new Error("Polling timed out");
+      }
+      const job = await this.getJob(jobId);
+      options.onPoll?.(job);
+      if (job.status === "completed" || job.status === "failed") {
+        return job;
+      }
+      await new Promise((resolve) => setTimeout(resolve, intervalMs));
+    }
+  }
+};
+export {
+  SyncsnapServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  CreateJobResponse,\n  Job,\n  PresignedUrlResponse,\n  WaitForJobOptions,\n} from './types';\n\nconst SYNCSNAP_API_BASE_URL = 'https://api.syncsnap.xyz/api';\n\nexport class SyncsnapServer {\n  private readonly baseUrl: string;\n  private readonly token: string;\n  private readonly fetcher: typeof fetch;\n\n  constructor(apiVersion: string = 'v1') {\n    this.baseUrl = `${SYNCSNAP_API_BASE_URL}/${apiVersion}`;\n    this.token = process.env.SYNCSNAP_TOKEN!;\n    this.fetcher = fetch;\n  }\n\n  private authHeaders(): HeadersInit {\n    return {\n      'Content-Type': 'application/json',\n      'X-API-KEY': this.token,\n    };\n  }\n\n  private async requestJson<T>(url: string, init?: RequestInit): Promise<T> {\n    const res = await this.fetcher(url, init);\n    const data = (await res.json().catch(() => ({}))) as T & {\n      error?: string;\n    };\n\n    if (!res.ok) {\n      const message =\n        typeof data === 'object' && data && 'error' in data && data.error\n          ? String(data.error)\n          : `Syncsnap request failed (${res.status})`;\n      throw new Error(message);\n    }\n\n    return data as T;\n  }\n\n  async createJob(): Promise<CreateJobResponse> {\n    const url = `${this.baseUrl}/jobs`;\n    return this.requestJson<CreateJobResponse>(url, {\n      method: 'POST',\n      headers: this.authHeaders(),\n    });\n  }\n\n  async getJob(jobId: string): Promise<Job> {\n    const url = `${this.baseUrl}/jobs/${encodeURIComponent(jobId)}`;\n    return this.requestJson<Job>(url, {\n      method: 'GET',\n      headers: this.authHeaders(),\n    });\n  }\n\n  async getUploadUrl(\n    jobId: string,\n    options: { fileName: string; expirationMinutes?: number }\n  ): Promise<PresignedUrlResponse> {\n    const url = `${this.baseUrl}/jobs/${encodeURIComponent(\n      jobId\n    )}/presigned-upload-url`;\n    return this.requestJson<PresignedUrlResponse>(url, {\n      method: 'POST',\n      headers: this.authHeaders(),\n      body: JSON.stringify({\n        file_name: options.fileName,\n        expiration: options.expirationMinutes,\n      }),\n    });\n  }\n\n  async getDownloadUrl(\n    jobId: string,\n    options?: { expirationMinutes?: number }\n  ): Promise<PresignedUrlResponse> {\n    const url = `${this.baseUrl}/jobs/${encodeURIComponent(\n      jobId\n    )}/presigned-download-url`;\n    return this.requestJson<PresignedUrlResponse>(url, {\n      method: 'POST',\n      headers: this.authHeaders(),\n      body: JSON.stringify({\n        expiration: options?.expirationMinutes,\n      }),\n    });\n  }\n\n  async waitForJobCompletion(\n    jobId: string,\n    options: WaitForJobOptions = {}\n  ): Promise<Job> {\n    const intervalMs = options.intervalMs ?? 2000;\n    const timeoutMs = options.timeoutMs ?? 120000;\n    const startedAt = Date.now();\n\n    while (true) {\n      if (options.signal?.aborted) {\n        throw new Error('Polling aborted');\n      }\n      if (Date.now() - startedAt > timeoutMs) {\n        throw new Error('Polling timed out');\n      }\n\n      const job = await this.getJob(jobId);\n      options.onPoll?.(job);\n\n      if (job.status === 'completed' || job.status === 'failed') {\n        return job;\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, intervalMs));\n    }\n  }\n}\n"],"mappings":";AAOA,IAAM,wBAAwB;AAEvB,IAAM,iBAAN,MAAqB;AAAA,EAK1B,YAAY,aAAqB,MAAM;AACrC,SAAK,UAAU,GAAG,qBAAqB,IAAI,UAAU;AACrD,SAAK,QAAQ,QAAQ,IAAI;AACzB,SAAK,UAAU;AAAA,EACjB;AAAA,EAEQ,cAA2B;AACjC,WAAO;AAAA,MACL,gBAAgB;AAAA,MAChB,aAAa,KAAK;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,MAAc,YAAe,KAAa,MAAgC;AACxE,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,IAAI;AACxC,UAAM,OAAQ,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAI/C,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UACJ,OAAO,SAAS,YAAY,QAAQ,WAAW,QAAQ,KAAK,QACxD,OAAO,KAAK,KAAK,IACjB,4BAA4B,IAAI,MAAM;AAC5C,YAAM,IAAI,MAAM,OAAO;AAAA,IACzB;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,YAAwC;AAC5C,UAAM,MAAM,GAAG,KAAK,OAAO;AAC3B,WAAO,KAAK,YAA+B,KAAK;AAAA,MAC9C,QAAQ;AAAA,MACR,SAAS,KAAK,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAO,OAA6B;AACxC,UAAM,MAAM,GAAG,KAAK,OAAO,SAAS,mBAAmB,KAAK,CAAC;AAC7D,WAAO,KAAK,YAAiB,KAAK;AAAA,MAChC,QAAQ;AAAA,MACR,SAAS,KAAK,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,aACJ,OACA,SAC+B;AAC/B,UAAM,MAAM,GAAG,KAAK,OAAO,SAAS;AAAA,MAClC;AAAA,IACF,CAAC;AACD,WAAO,KAAK,YAAkC,KAAK;AAAA,MACjD,QAAQ;AAAA,MACR,SAAS,KAAK,YAAY;AAAA,MAC1B,MAAM,KAAK,UAAU;AAAA,QACnB,WAAW,QAAQ;AAAA,QACnB,YAAY,QAAQ;AAAA,MACtB,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,eACJ,OACA,SAC+B;AAC/B,UAAM,MAAM,GAAG,KAAK,OAAO,SAAS;AAAA,MAClC;AAAA,IACF,CAAC;AACD,WAAO,KAAK,YAAkC,KAAK;AAAA,MACjD,QAAQ;AAAA,MACR,SAAS,KAAK,YAAY;AAAA,MAC1B,MAAM,KAAK,UAAU;AAAA,QACnB,YAAY,SAAS;AAAA,MACvB,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,qBACJ,OACA,UAA6B,CAAC,GAChB;AACd,UAAM,aAAa,QAAQ,cAAc;AACzC,UAAM,YAAY,QAAQ,aAAa;AACvC,UAAM,YAAY,KAAK,IAAI;AAE3B,WAAO,MAAM;AACX,UAAI,QAAQ,QAAQ,SAAS;AAC3B,cAAM,IAAI,MAAM,iBAAiB;AAAA,MACnC;AACA,UAAI,KAAK,IAAI,IAAI,YAAY,WAAW;AACtC,cAAM,IAAI,MAAM,mBAAmB;AAAA,MACrC;AAEA,YAAM,MAAM,MAAM,KAAK,OAAO,KAAK;AACnC,cAAQ,SAAS,GAAG;AAEpB,UAAI,IAAI,WAAW,eAAe,IAAI,WAAW,UAAU;AACzD,eAAO;AAAA,MACT;AAEA,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,UAAU,CAAC;AAAA,IAChE;AAAA,EACF;AACF;","names":[]}

package/dist/next.d.ts

@@ -0,0 +1,30 @@
+import { SyncsnapServer, Job, PresignedUrlResponse } from './index.js';
+
+type NextParams = {
+    params: {
+        id: string;
+    } | Promise<{
+        id: string;
+    }>;
+};
+type CatchAllParams = {
+    params?: Record<string, string | string[] | undefined> | Promise<Record<string, string | string[] | undefined>>;
+};
+declare function createJobHandler(client: SyncsnapServer): () => Promise<Response>;
+declare function getJobHandler(client: SyncsnapServer): (_request: Request, context: NextParams) => Promise<Response>;
+declare function getDownloadUrlHandler(client: SyncsnapServer): (request: Request, context: NextParams) => Promise<Response>;
+interface CreateRouteHandlerOptions {
+    client: SyncsnapServer;
+    /**
+     * Called when a job completes (after server-side polling). Receives the job and, when
+     * status is "completed", the presigned download URL. Whatever this returns is sent to
+     * the client and passed to `useSyncsnapJob`'s `onCompleted(job, result)`.
+     */
+    onCompleted?: (job: Job, presigned?: PresignedUrlResponse) => unknown | Promise<unknown>;
+}
+declare function createRouteHandler(options: CreateRouteHandlerOptions): {
+    GET: (request: Request, context: CatchAllParams) => Promise<Response>;
+    POST: (_request: Request, context: CatchAllParams) => Promise<Response>;
+};
+
+export { type CreateRouteHandlerOptions, Job, createJobHandler, createRouteHandler, getDownloadUrlHandler, getJobHandler };

package/dist/next.js

@@ -0,0 +1,155 @@
+// src/next/route-handlers.ts
+function json(data, init) {
+  return new Response(JSON.stringify(data), {
+    ...init,
+    headers: {
+      "Content-Type": "application/json",
+      ...init?.headers ?? {}
+    }
+  });
+}
+function parseExpiration(url) {
+  const { searchParams } = new URL(url);
+  const raw = searchParams.get("expiration");
+  if (!raw) return void 0;
+  const value = Number(raw);
+  return Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function parseWaitOptions(url) {
+  const { searchParams } = new URL(url);
+  const timeoutMs = parseOptionalPositiveNumber(searchParams.get("timeoutMs"));
+  const intervalMs = parseOptionalPositiveNumber(
+    searchParams.get("intervalMs")
+  );
+  return { timeoutMs, intervalMs };
+}
+function parseOptionalPositiveNumber(value) {
+  if (value == null) return void 0;
+  const n = Number(value);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+async function resolveParams(params) {
+  if (!params) return void 0;
+  if (typeof params.then === "function") {
+    return await params;
+  }
+  return params;
+}
+function getCatchAllPath(params) {
+  if (!params) return [];
+  for (const value of Object.values(params)) {
+    if (Array.isArray(value)) return value;
+    if (typeof value === "string" && value.length > 0) return [value];
+  }
+  return [];
+}
+function createJobHandler(client) {
+  return async function POST() {
+    const job = await client.createJob();
+    return json(job);
+  };
+}
+function getJobHandler(client) {
+  return async function GET(_request, context) {
+    const resolved = await resolveParams(context.params);
+    if (!resolved?.id) {
+      return json({ error: "Job id is required" }, { status: 400 });
+    }
+    const job = await client.getJob(resolved.id);
+    return json(job);
+  };
+}
+function getDownloadUrlHandler(client) {
+  return async function GET(request, context) {
+    const resolved = await resolveParams(context.params);
+    if (!resolved?.id) {
+      return json({ error: "Job id is required" }, { status: 400 });
+    }
+    const expirationMinutes = parseExpiration(request.url);
+    const response = await client.getDownloadUrl(
+      resolved.id,
+      { expirationMinutes }
+    );
+    return json(response);
+  };
+}
+function createRouteHandler(options) {
+  const { client, onCompleted: onCompletedCallback } = options;
+  return {
+    GET: async (request, context) => {
+      const resolved = await resolveParams(context.params);
+      const segments = getCatchAllPath(resolved);
+      if (segments.length === 2 && segments[0] === "job") {
+        const job = await client.getJob(segments[1]);
+        return json(job);
+      }
+      if (segments.length === 3 && segments[0] === "job" && segments[2] === "download") {
+        const jobId = segments[1];
+        const job = await client.getJob(jobId);
+        if (job.status !== "completed") {
+          return json({ error: "Job is not completed" }, { status: 400 });
+        }
+        const expirationMinutes = parseExpiration(request.url);
+        const presigned = await client.getDownloadUrl(
+          jobId,
+          {
+            expirationMinutes
+          }
+        );
+        const response = { ...presigned };
+        if (onCompletedCallback) {
+          const payload = await onCompletedCallback(job, presigned);
+          if (payload !== void 0) {
+            response.completedPayload = payload;
+          }
+        }
+        return json(response);
+      }
+      if (segments.length === 3 && segments[0] === "job" && segments[2] === "wait") {
+        const jobId = segments[1];
+        const { timeoutMs, intervalMs } = parseWaitOptions(request.url);
+        try {
+          const job = await client.waitForJobCompletion(jobId, {
+            timeoutMs,
+            intervalMs
+          });
+          const body = { job };
+          if (job.status === "completed") {
+            const presigned = await client.getDownloadUrl(jobId);
+            const result = onCompletedCallback ? await onCompletedCallback(job, presigned) : presigned;
+            if (result !== void 0) {
+              body.result = result;
+            }
+          } else if (onCompletedCallback) {
+            const result = await onCompletedCallback(job);
+            if (result !== void 0) {
+              body.result = result;
+            }
+          }
+          return json(body);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : "Wait failed";
+          const isTimeout = message.includes("timed out") || message.includes("Polling timed out");
+          return json({ error: message }, { status: isTimeout ? 408 : 500 });
+        }
+      }
+      return json({ error: "Not found" }, { status: 404 });
+    },
+    POST: async (_request, context) => {
+      const resolved = await resolveParams(context.params);
+      const segments = getCatchAllPath(resolved);
+      if (segments.length === 1 && segments[0] === "job") {
+        const job = await client.createJob();
+        return json(job);
+      }
+      return json({ error: "Not found" }, { status: 404 });
+    }
+  };
+}
+export {
+  createJobHandler,
+  createRouteHandler,
+  getDownloadUrlHandler,
+  getJobHandler
+};
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next/route-handlers.ts"],"sourcesContent":["import type { SyncsnapServer } from '../client';\nimport type {\n  DownloadUrlResponse,\n  Job,\n  PresignedUrlResponse,\n  WaitCompletionResponse,\n} from '../types';\n\ntype NextParams = { params: { id: string } | Promise<{ id: string }> };\ntype CatchAllParams = {\n  params?:\n    | Record<string, string | string[] | undefined>\n    | Promise<Record<string, string | string[] | undefined>>;\n};\n\nfunction json(data: unknown, init?: ResponseInit): Response {\n  return new Response(JSON.stringify(data), {\n    ...init,\n    headers: {\n      'Content-Type': 'application/json',\n      ...(init?.headers ?? {}),\n    },\n  });\n}\n\nfunction parseExpiration(url: string): number | undefined {\n  const { searchParams } = new URL(url);\n  const raw = searchParams.get('expiration');\n  if (!raw) return undefined;\n  const value = Number(raw);\n  return Number.isFinite(value) && value > 0 ? value : undefined;\n}\n\nfunction parseWaitOptions(url: string): {\n  timeoutMs?: number;\n  intervalMs?: number;\n} {\n  const { searchParams } = new URL(url);\n  const timeoutMs = parseOptionalPositiveNumber(searchParams.get('timeoutMs'));\n  const intervalMs = parseOptionalPositiveNumber(\n    searchParams.get('intervalMs')\n  );\n  return { timeoutMs, intervalMs };\n}\n\nfunction parseOptionalPositiveNumber(value: string | null): number | undefined {\n  if (value == null) return undefined;\n  const n = Number(value);\n  return Number.isFinite(n) && n > 0 ? n : undefined;\n}\n\nasync function resolveParams<T>(\n  params?: T | Promise<T>\n): Promise<T | undefined> {\n  if (!params) return undefined;\n  if (typeof (params as Promise<T>).then === 'function') {\n    return await (params as Promise<T>);\n  }\n  return params as T;\n}\n\nfunction getCatchAllPath(\n  params?: Record<string, string | string[] | undefined>\n): string[] {\n  if (!params) return [];\n  for (const value of Object.values(params)) {\n    if (Array.isArray(value)) return value;\n    if (typeof value === 'string' && value.length > 0) return [value];\n  }\n  return [];\n}\n\nexport function createJobHandler(client: SyncsnapServer) {\n  return async function POST(): Promise<Response> {\n    const job = await client.createJob();\n    return json(job);\n  };\n}\n\nexport function getJobHandler(client: SyncsnapServer) {\n  return async function GET(\n    _request: Request,\n    context: NextParams\n  ): Promise<Response> {\n    const resolved = await resolveParams(context.params);\n    if (!resolved?.id) {\n      return json({ error: 'Job id is required' }, { status: 400 });\n    }\n    const job = await client.getJob(resolved.id);\n    return json(job);\n  };\n}\n\nexport function getDownloadUrlHandler(client: SyncsnapServer) {\n  return async function GET(\n    request: Request,\n    context: NextParams\n  ): Promise<Response> {\n    const resolved = await resolveParams(context.params);\n    if (!resolved?.id) {\n      return json({ error: 'Job id is required' }, { status: 400 });\n    }\n    const expirationMinutes = parseExpiration(request.url);\n    const response: PresignedUrlResponse = await client.getDownloadUrl(\n      resolved.id,\n      { expirationMinutes }\n    );\n    return json(response);\n  };\n}\n\nexport interface CreateRouteHandlerOptions {\n  client: SyncsnapServer;\n  /**\n   * Called when a job completes (after server-side polling). Receives the job and, when\n   * status is \"completed\", the presigned download URL. Whatever this returns is sent to\n   * the client and passed to `useSyncsnapJob`'s `onCompleted(job, result)`.\n   */\n  onCompleted?: (\n    job: Job,\n    presigned?: PresignedUrlResponse\n  ) => unknown | Promise<unknown>;\n}\n\nexport function createRouteHandler(options: CreateRouteHandlerOptions) {\n  const { client, onCompleted: onCompletedCallback } = options;\n\n  return {\n    GET: async (\n      request: Request,\n      context: CatchAllParams\n    ): Promise<Response> => {\n      const resolved = await resolveParams(context.params);\n      const segments = getCatchAllPath(resolved);\n      if (segments.length === 2 && segments[0] === 'job') {\n        const job = await client.getJob(segments[1]);\n        return json(job);\n      }\n\n      if (\n        segments.length === 3 &&\n        segments[0] === 'job' &&\n        segments[2] === 'download'\n      ) {\n        const jobId = segments[1];\n        const job = await client.getJob(jobId);\n        if (job.status !== 'completed') {\n          return json({ error: 'Job is not completed' }, { status: 400 });\n        }\n        const expirationMinutes = parseExpiration(request.url);\n        const presigned: PresignedUrlResponse = await client.getDownloadUrl(\n          jobId,\n          {\n            expirationMinutes,\n          }\n        );\n        const response: DownloadUrlResponse = { ...presigned };\n        if (onCompletedCallback) {\n          const payload = await onCompletedCallback(job, presigned);\n          if (payload !== undefined) {\n            response.completedPayload = payload;\n          }\n        }\n        return json(response);\n      }\n\n      if (\n        segments.length === 3 &&\n        segments[0] === 'job' &&\n        segments[2] === 'wait'\n      ) {\n        const jobId = segments[1];\n        const { timeoutMs, intervalMs } = parseWaitOptions(request.url);\n        try {\n          const job = await client.waitForJobCompletion(jobId, {\n            timeoutMs,\n            intervalMs,\n          });\n          const body: WaitCompletionResponse = { job };\n          if (job.status === 'completed') {\n            const presigned: PresignedUrlResponse =\n              await client.getDownloadUrl(jobId);\n            const result = onCompletedCallback\n              ? await onCompletedCallback(job, presigned)\n              : presigned;\n            if (result !== undefined) {\n              body.result = result;\n            }\n          } else if (onCompletedCallback) {\n            const result = await onCompletedCallback(job);\n            if (result !== undefined) {\n              body.result = result;\n            }\n          }\n          return json(body);\n        } catch (err) {\n          const message = err instanceof Error ? err.message : 'Wait failed';\n          const isTimeout =\n            message.includes('timed out') ||\n            message.includes('Polling timed out');\n          return json({ error: message }, { status: isTimeout ? 408 : 500 });\n        }\n      }\n\n      return json({ error: 'Not found' }, { status: 404 });\n    },\n    POST: async (\n      _request: Request,\n      context: CatchAllParams\n    ): Promise<Response> => {\n      const resolved = await resolveParams(context.params);\n      const segments = getCatchAllPath(resolved);\n      if (segments.length === 1 && segments[0] === 'job') {\n        const job = await client.createJob();\n        return json(job);\n      }\n\n      return json({ error: 'Not found' }, { status: 404 });\n    },\n  };\n}\n\nexport type { Job };\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "syncsnap",
+  "version": "1.0.0",
+  "description": "Syncsnap server SDK for Node/Next.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncsnap/packages.git",
+    "directory": "syncsnap"
+  },
+  "homepage": "https://github.com/syncsnap/packages/syncsnap#readme",
+  "bugs": {
+    "url": "https://github.com/syncsnap/packages/syncsnap/issues"
+  },
+  "keywords": [
+    "syncsnap",
+    "server",
+    "sdk",
+    "next.js",
+    "api",
+    "file-sync"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.2.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "build": "tsup src/index.ts src/next.ts --dts --format esm --out-dir dist --clean --sourcemap",
+    "publish": "npm publish --provenance --access public",
+    "link": "npm run build && npm link",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}