@secondlayer/sdk 0.10.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../src/errors.ts", "../src/base.ts", "../src/streams/client.ts"],
4
- "sourcesContent": [
5
- "/**\n * Error thrown by {@link SecondLayer} when an API request fails.\n * Includes the HTTP status code for programmatic error handling.\n *\n * @example\n * ```ts\n * try {\n * await client.streams.get(\"abc123\");\n * } catch (err) {\n * if (err instanceof ApiError && err.status === 404) {\n * console.log(\"Stream not found\");\n * }\n * }\n * ```\n */\nexport class ApiError extends Error {\n\tconstructor(\n\t\t/** HTTP status code (0 for network errors). */\n\t\tpublic status: number,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"ApiError\";\n\t}\n}\n",
6
- "import { ApiError } from \"./errors.ts\";\n\nexport interface SecondLayerOptions {\n\t/** Base URL of the Secondlayer API (trailing slashes are stripped). */\n\tbaseUrl: string;\n\t/** Bearer token for authenticated requests. */\n\tapiKey?: string;\n}\n\nconst DEFAULT_BASE_URL = \"https://api.secondlayer.tools\";\n\nexport abstract class BaseClient {\n\tprotected baseUrl: string;\n\tprotected apiKey?: string;\n\n\tconstructor(options: Partial<SecondLayerOptions> = {}) {\n\t\tthis.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n\t\tthis.apiKey = options.apiKey;\n\t}\n\n\tstatic authHeaders(apiKey?: string): Record<string, string> {\n\t\tconst headers: Record<string, string> = {\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t};\n\t\tif (apiKey) {\n\t\t\theaders[\"Authorization\"] = `Bearer ${apiKey}`;\n\t\t}\n\t\treturn headers;\n\t}\n\n\tprotected async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody?: unknown,\n\t): Promise<T> {\n\t\tconst url = `${this.baseUrl}${path}`;\n\t\tconst headers = BaseClient.authHeaders(this.apiKey);\n\n\t\tlet response: Response;\n\t\ttry {\n\t\t\tresponse = await fetch(url, {\n\t\t\t\tmethod,\n\t\t\t\theaders,\n\t\t\t\tbody: body ? JSON.stringify(body) : undefined,\n\t\t\t});\n\t\t} catch {\n\t\t\tthrow new ApiError(\n\t\t\t\t0,\n\t\t\t\t`Cannot reach API at ${this.baseUrl}. Check your connection or try again.`,\n\t\t\t);\n\t\t}\n\n\t\tif (!response.ok) {\n\t\t\tif (response.status === 401) {\n\t\t\t\tthrow new ApiError(401, \"API key invalid or expired.\");\n\t\t\t}\n\n\t\t\tif (response.status === 429) {\n\t\t\t\tconst retryAfter = response.headers.get(\"Retry-After\");\n\t\t\t\tconst msg = retryAfter\n\t\t\t\t\t? `Rate limited. Wait ${retryAfter} seconds.`\n\t\t\t\t\t: \"Rate limited. Try again later.\";\n\t\t\t\tthrow new ApiError(429, msg);\n\t\t\t}\n\n\t\t\tif (response.status >= 500) {\n\t\t\t\tthrow new ApiError(\n\t\t\t\t\tresponse.status,\n\t\t\t\t\t`Server error. Try again or check status at ${this.baseUrl}/health`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst errorBody = await response.text();\n\t\t\tlet message = `HTTP ${response.status}`;\n\t\t\ttry {\n\t\t\t\tconst json = JSON.parse(errorBody);\n\t\t\t\tconst err = json.error ?? json.message;\n\t\t\t\tif (typeof err === \"string\") {\n\t\t\t\t\tmessage = err;\n\t\t\t\t} else if (err && typeof err === \"object\") {\n\t\t\t\t\tmessage = JSON.stringify(err);\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\tif (errorBody) message = errorBody;\n\t\t\t}\n\t\t\tthrow new ApiError(response.status, message);\n\t\t}\n\n\t\tif (response.status === 204) {\n\t\t\treturn undefined as T;\n\t\t}\n\n\t\treturn response.json() as Promise<T>;\n\t}\n}\n",
7
- "import type {\n\tBulkPauseResponse,\n\tBulkResumeResponse,\n\tCreateStream,\n\tCreateStreamResponse,\n\tListStreamsResponse,\n\tStreamResponse,\n\tUpdateStream,\n} from \"@secondlayer/shared/schemas\";\nimport { BaseClient } from \"../base.ts\";\nimport { ApiError } from \"../errors.ts\";\n\nexport interface DeliverySummary {\n\tid: string;\n\tblockHeight: number;\n\tstatus: string;\n\tstatusCode: number | null;\n\tresponseTimeMs: number | null;\n\tattempts: number;\n\terror: string | null;\n\tcreatedAt: string;\n}\n\nexport interface DeliveryDetail extends DeliverySummary {\n\tpayload: unknown;\n}\n\nexport interface DeliveriesResponse {\n\tdeliveries: DeliverySummary[];\n}\n\nexport class Streams extends BaseClient {\n\tprivate async requestWithStreamId<T>(\n\t\tmethod: string,\n\t\tpathTemplate: (id: string) => string,\n\t\tid: string,\n\t\tbody?: unknown,\n\t): Promise<T> {\n\t\tconst fullId = await this.resolveStreamId(id);\n\t\treturn this.request<T>(method, pathTemplate(fullId), body);\n\t}\n\n\tasync resolveStreamId(partialId: string): Promise<string> {\n\t\tif (partialId.length === 36 && partialId.includes(\"-\")) {\n\t\t\treturn partialId;\n\t\t}\n\n\t\tconst { streams } = await this.list();\n\t\tconst matches = streams.filter((s) => s.id.startsWith(partialId));\n\n\t\tif (matches.length === 0) {\n\t\t\tthrow new ApiError(404, `No stream found matching \"${partialId}\"`);\n\t\t}\n\t\tif (matches.length > 1) {\n\t\t\tthrow new ApiError(\n\t\t\t\t400,\n\t\t\t\t`Multiple streams match \"${partialId}\": ${matches.map((s) => s.id.slice(0, 8)).join(\", \")}`,\n\t\t\t);\n\t\t}\n\n\t\treturn matches[0]!.id;\n\t}\n\n\tasync create(data: CreateStream): Promise<CreateStreamResponse> {\n\t\treturn this.request<CreateStreamResponse>(\"POST\", \"/api/streams\", data);\n\t}\n\n\tasync update(id: string, data: UpdateStream): Promise<StreamResponse> {\n\t\treturn this.requestWithStreamId(\n\t\t\t\"PATCH\",\n\t\t\t(id) => `/api/streams/${id}`,\n\t\t\tid,\n\t\t\tdata,\n\t\t);\n\t}\n\n\tasync updateByName(\n\t\tname: string,\n\t\tdata: CreateStream,\n\t): Promise<StreamResponse> {\n\t\tconst { streams } = await this.list();\n\t\tconst existing = streams.find((s) => s.name === name);\n\t\tif (!existing) {\n\t\t\tthrow new ApiError(404, `Stream with name \"${name}\" not found`);\n\t\t}\n\t\treturn this.update(existing.id, data);\n\t}\n\n\tasync list(params?: { status?: string }): Promise<ListStreamsResponse> {\n\t\tconst searchParams = new URLSearchParams();\n\t\tif (params?.status) searchParams.set(\"status\", params.status);\n\t\tconst query = searchParams.toString();\n\t\tconst path = query ? `/api/streams?${query}` : \"/api/streams\";\n\t\treturn this.request<ListStreamsResponse>(\"GET\", path);\n\t}\n\n\tasync get(id: string): Promise<StreamResponse> {\n\t\treturn this.requestWithStreamId(\"GET\", (id) => `/api/streams/${id}`, id);\n\t}\n\n\tasync delete(id: string): Promise<void> {\n\t\treturn this.requestWithStreamId(\"DELETE\", (id) => `/api/streams/${id}`, id);\n\t}\n\n\tasync enable(id: string): Promise<StreamResponse> {\n\t\treturn this.requestWithStreamId(\n\t\t\t\"POST\",\n\t\t\t(id) => `/api/streams/${id}/enable`,\n\t\t\tid,\n\t\t);\n\t}\n\n\tasync disable(id: string): Promise<StreamResponse> {\n\t\treturn this.requestWithStreamId(\n\t\t\t\"POST\",\n\t\t\t(id) => `/api/streams/${id}/disable`,\n\t\t\tid,\n\t\t);\n\t}\n\n\tasync rotateSecret(id: string): Promise<{ secret: string }> {\n\t\treturn this.requestWithStreamId(\n\t\t\t\"POST\",\n\t\t\t(id) => `/api/streams/${id}/rotate-secret`,\n\t\t\tid,\n\t\t);\n\t}\n\n\t// ── Deliveries ─────────────────────────────────────────────────────\n\n\t/** List recent deliveries for a stream. */\n\tasync listDeliveries(\n\t\tid: string,\n\t\tparams?: { limit?: number; status?: string },\n\t): Promise<DeliveriesResponse> {\n\t\tconst qs = new URLSearchParams();\n\t\tif (params?.limit !== undefined) qs.set(\"limit\", String(params.limit));\n\t\tif (params?.status) qs.set(\"status\", params.status);\n\t\tconst query = qs.toString();\n\t\treturn this.requestWithStreamId(\n\t\t\t\"GET\",\n\t\t\t(id) => `/api/streams/${id}/deliveries${query ? `?${query}` : \"\"}`,\n\t\t\tid,\n\t\t);\n\t}\n\n\t/** Get a single delivery with full payload. */\n\tasync getDelivery(\n\t\tstreamId: string,\n\t\tdeliveryId: string,\n\t): Promise<DeliveryDetail> {\n\t\tconst fullId = await this.resolveStreamId(streamId);\n\t\treturn this.request<DeliveryDetail>(\n\t\t\t\"GET\",\n\t\t\t`/api/streams/${fullId}/deliveries/${deliveryId}`,\n\t\t);\n\t}\n\n\tasync pauseAll(): Promise<BulkPauseResponse> {\n\t\treturn this.request<BulkPauseResponse>(\"POST\", \"/api/streams/pause\");\n\t}\n\n\tasync resumeAll(): Promise<BulkResumeResponse> {\n\t\treturn this.request<BulkResumeResponse>(\"POST\", \"/api/streams/resume\");\n\t}\n}\n"
8
- ],
9
- "mappings": "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",
10
- "debugId": "C6255FAFEE54D50164756E2164756E21",
11
- "names": []
12
- }