@becklinks/next 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Beck Link
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @becklinks/next
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Beck Links for Next.js 14 and newer (App Router and Pages Router). Two entry points:
+
+- `@becklinks/next`: for the browser. The provider, the `useCreateLink` hook and the `SmartBanner`
+  component, already marked `'use client'`.
+- `@becklinks/next/server`: for your server code. Creates links with your **secret key**.
+
+```bash
+npm install @becklinks/next
+```
+
+```tsx
+// app/beck-links.tsx
+'use client';
+
+import { BeckLinksProvider, SmartBanner } from '@becklinks/next';
+
+export function BeckLinks({ children }: { children: React.ReactNode }) {
+  return (
+    <BeckLinksProvider publishableKey={process.env.NEXT_PUBLIC_BECKLINKS_KEY ?? ''}>
+      <SmartBanner url="https://yourproject.becklinks.com/summer" title="Open in the Acme app" />
+      {children}
+    </BeckLinksProvider>
+  );
+}
+```
+
+```ts
+// app/api/share/route.ts
+import { createServerBeckLinks } from '@becklinks/next/server';
+
+const beckLinks = createServerBeckLinks(); // reads BECKLINKS_SECRET_KEY
+
+export async function POST() {
+  const link = await beckLinks.createLink({ deepLinkPath: '/product/42', path: 'p-42' });
+  return Response.json({ url: link.url });
+}
+```
+
+Only the **publishable** key (`pk_…`) may carry the `NEXT_PUBLIC_` prefix. The secret key
+(`sk_…`) lives in a server-only environment variable; the server helper refuses a publishable key and
+refuses to run in a browser. List your website under **Settings → Web origins** in the Beck Links
+dashboard so browsers may use the publishable key.
+
+Documentation: [docs.becklinks.com/nextjs-sdk](https://docs.becklinks.com/nextjs-sdk) · MIT licensed,
+made by [Tecbeck](https://tecbeck.com).

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { BeckLinksProviderProps } from '@becklinks/react';
+import type { ReactElement } from 'react';
+/** The provider of @becklinks/react, reporting itself as `becklinks_next`. */
+export declare function BeckLinksProvider(props: BeckLinksProviderProps): ReactElement;
+export { SmartBanner, useBeckLinks, useCreateLink, BeckLinksError } from '@becklinks/react';
+export type { BannerHandle, BannerOptions, BeckLink, BeckLinksClient, BeckLinksOptions, BeckLinksProviderProps, CreateLinkInput, MobilePlatform, SmartBannerProps, UseCreateLink, UtmParameters, } from '@becklinks/react';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAM7E;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5F,YAAY,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+'use client';
+// Client entry of @becklinks/next. Everything here runs in the browser (it is marked
+// 'use client'), so import it from Client Components or from a small client wrapper in your
+// layout. The secret-key helper lives in '@becklinks/next/server'.
+import { BeckLinksProvider as ReactProvider } from '@becklinks/react';
+import { createElement } from 'react';
+const NEXT_SDK_NAME = 'becklinks_next';
+const NEXT_SDK_VERSION = '0.1.0';
+/** The provider of @becklinks/react, reporting itself as `becklinks_next`. */
+export function BeckLinksProvider(props) {
+    return createElement(ReactProvider, {
+        sdkName: NEXT_SDK_NAME,
+        sdkVersion: NEXT_SDK_VERSION,
+        ...props,
+    });
+}
+export { SmartBanner, useBeckLinks, useCreateLink, BeckLinksError } from '@becklinks/react';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,qFAAqF;AACrF,4FAA4F;AAC5F,mEAAmE;AACnE,OAAO,EAAE,iBAAiB,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAKtC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,OAAO,aAAa,CAAC,aAAa,EAAE;QAClC,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,gBAAgB;QAC5B,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,37 @@
+import type { CreateLinkInput } from '@becklinks/web';
+export { BeckLinksError } from '@becklinks/web';
+export type { CreateLinkInput, UtmParameters } from '@becklinks/web';
+export interface ServerBeckLinksOptions {
+    /** Defaults to the `BECKLINKS_SECRET_KEY` environment variable. */
+    readonly secretKey?: string;
+    readonly apiUrl?: string;
+    /** Per request, default 10 000 ms. */
+    readonly timeoutMs?: number;
+    readonly fetch?: typeof fetch;
+}
+export interface ServerLinkInput extends CreateLinkInput {
+    /** A custom short path, 1–64 characters of letters, digits, "-" and "_". Omit for a generated one. */
+    readonly path?: string;
+    /** A label for the dashboard. */
+    readonly name?: string;
+}
+export interface ServerLink {
+    readonly id: string;
+    readonly url: string;
+    readonly path: string;
+    readonly status: string;
+    readonly createdAt: Date;
+    readonly expiresAt: Date | null;
+}
+export interface ServerBeckLinks {
+    /**
+     * Creates a link with the REST API (`POST /v1/links`). Pass `idempotencyKey` when you retry a
+     * call yourself: the same key returns the same link instead of a second one.
+     */
+    createLink: (input: ServerLinkInput, options?: {
+        idempotencyKey?: string;
+    }) => Promise<ServerLink>;
+}
+/** Creates the server helper. Throws `BeckLinksError` (kind `configuration`) for a bad key. */
+export declare function createServerBeckLinks(options?: ServerBeckLinksOptions): ServerBeckLinks;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOrE,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,sGAAsG;IACtG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,EAAE,CACV,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KAClC,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B;AAqDD,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAoF3F"}

package/dist/server.js

@@ -0,0 +1,138 @@
+// Server entry of @becklinks/next. It uses a SECRET key (`sk_…`), which must never reach a browser,
+// so it refuses to run where `window` exists. Use it in Route Handlers, Server Actions, Server
+// Components and `getServerSideProps`.
+import { BeckLinksError } from '@becklinks/web';
+export { BeckLinksError } from '@becklinks/web';
+const DEFAULT_API_URL = 'https://api.becklinks.com';
+const SECRET_KEY = /^sk_(test|live)_[A-Za-z0-9]{8,}$/;
+const SDK_NAME = 'becklinks_next';
+const SDK_VERSION = '0.1.0';
+function configurationError(message) {
+    return new BeckLinksError({ kind: 'configuration', message });
+}
+function text(record, name) {
+    const value = record[name];
+    if (typeof value !== 'string') {
+        throw new BeckLinksError({
+            kind: 'unexpected_response',
+            message: `The link response is missing "${name}".`,
+        });
+    }
+    return value;
+}
+function body(input) {
+    const expires = input.expiresAt === undefined ? undefined : new Date(input.expiresAt).toISOString();
+    return {
+        deep_link_path: input.deepLinkPath,
+        ...(input.path === undefined ? {} : { path: input.path }),
+        ...(input.name === undefined ? {} : { name: input.name }),
+        ...(input.data === undefined ? {} : { data: input.data }),
+        ...(input.campaign === undefined ? {} : { campaign: input.campaign }),
+        ...(input.utm === undefined ? {} : { utm: input.utm }),
+        ...(expires === undefined ? {} : { expires_at: expires }),
+    };
+}
+async function readProblem(response) {
+    let problem = {};
+    try {
+        const parsed = await response.json();
+        if (typeof parsed === 'object' && parsed !== null)
+            problem = parsed;
+    }
+    catch {
+        // Not JSON: the status says enough.
+    }
+    const code = typeof problem.code === 'string' ? problem.code : undefined;
+    const detail = typeof problem.detail === 'string' ? problem.detail : undefined;
+    const requestId = response.headers.get('x-request-id');
+    const retryAfter = Number(response.headers.get('retry-after'));
+    return new BeckLinksError({
+        kind: 'api',
+        message: detail ?? `The API answered ${String(response.status)}.`,
+        status: response.status,
+        ...(code === undefined ? {} : { code }),
+        ...(requestId === null ? {} : { requestId }),
+        ...(Number.isFinite(retryAfter) && retryAfter > 0 ? { retryAfterSeconds: retryAfter } : {}),
+    });
+}
+/** Creates the server helper. Throws `BeckLinksError` (kind `configuration`) for a bad key. */
+export function createServerBeckLinks(options = {}) {
+    if (typeof window !== 'undefined') {
+        throw configurationError('@becklinks/next/server uses a secret key and must run on the server, never in the browser.');
+    }
+    const secretKey = options.secretKey ?? process.env.BECKLINKS_SECRET_KEY;
+    if (secretKey === undefined || secretKey === '') {
+        throw configurationError('No secret key. Set BECKLINKS_SECRET_KEY (sk_test_… or sk_live_…) or pass secretKey.');
+    }
+    if (secretKey.startsWith('pk_')) {
+        throw configurationError('This is a publishable key (pk_…). The server helper needs a secret key (sk_…).');
+    }
+    if (!SECRET_KEY.test(secretKey)) {
+        throw configurationError('secretKey must look like sk_test_… or sk_live_….');
+    }
+    const apiUrl = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/+$/, '');
+    if (!apiUrl.startsWith('https://') &&
+        !/^http:\/\/(localhost|[^/]*\.localhost)(:\d+)?$/.test(apiUrl)) {
+        throw configurationError('apiUrl must be https (http is accepted for localhost only).');
+    }
+    const fetchImpl = options.fetch ?? fetch;
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    return {
+        async createLink(input, callOptions) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => {
+                controller.abort();
+            }, timeoutMs);
+            let response;
+            try {
+                response = await fetchImpl(`${apiUrl}/v1/links`, {
+                    method: 'POST',
+                    headers: {
+                        authorization: `Bearer ${secretKey}`,
+                        'content-type': 'application/json',
+                        'idempotency-key': callOptions?.idempotencyKey ?? crypto.randomUUID(),
+                        'user-agent': `${SDK_NAME}/${SDK_VERSION}`,
+                        'x-sdk-name': SDK_NAME,
+                        'x-sdk-version': SDK_VERSION,
+                    },
+                    body: JSON.stringify(body(input)),
+                    signal: controller.signal,
+                    cache: 'no-store',
+                });
+            }
+            catch (error) {
+                throw new BeckLinksError({
+                    kind: 'network',
+                    message: controller.signal.aborted
+                        ? `The request timed out after ${String(timeoutMs)} ms.`
+                        : 'The request did not reach Beck Links.',
+                    cause: error,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok)
+                throw await readProblem(response);
+            const parsed = await response.json().catch(() => null);
+            if (typeof parsed !== 'object' || parsed === null) {
+                throw new BeckLinksError({
+                    kind: 'unexpected_response',
+                    message: 'The API answered with a body that is not JSON.',
+                    status: response.status,
+                });
+            }
+            const record = parsed;
+            const expiresAt = record.expires_at;
+            return {
+                id: text(record, 'id'),
+                url: text(record, 'url'),
+                path: text(record, 'path'),
+                status: text(record, 'status'),
+                createdAt: new Date(text(record, 'created_at')),
+                expiresAt: typeof expiresAt === 'string' ? new Date(expiresAt) : null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@becklinks/next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Beck Links for Next.js (App Router and Pages): client provider, hooks, banner, and a server helper that creates links with your secret key.",
+  "keywords": [
+    "nextjs",
+    "next",
+    "deep links",
+    "smart banner",
+    "becklinks"
+  ],
+  "homepage": "https://docs.becklinks.com/sdks/nextjs",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@becklinks/web": "^0.1.0",
+    "@becklinks/react": "^0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.1",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "eslint": "10.12.0",
+    "jsdom": "30.1.3",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "typescript": "6.0.3",
+    "vitest": "5.0.3",
+    "@becklink/config": "0.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "clean": "rimraf dist coverage"
+  }
 }