@wolin-id/client
v0.1.0
Published
Zero-dependency W3C Solid Pod client, Solid-OIDC PKCE helper, and RFC 9449 ES256 DPoP signer for Wolin (月印千江)
Downloads
464
Maintainers
Readme
@wolin-id/client
Zero-dependency TypeScript/JavaScript client for Wolin (月印千江) W3C Solid 0.11 Pods, Solid-OIDC + PKCE, and RFC 9449 ES256 DPoP.
Works natively in modern browsers, Node.js 20+, Cloudflare Workers, Deno, and Bun using standard Web Crypto (crypto.subtle) and fetch.
Production Endpoints
- Solid-OIDC Issuer & Signed Asset Gateway:
https://auth.wolin.id(DEFAULT_WOLIN_OIDC_ISSUER) - Multi-Tenant Solid Pod Engine:
https://pod.wolin.id(DEFAULT_WOLIN_POD_BASE_URL) - Tenant Pod Subdomain & WebID:
https://alice.wolin.id(https://alice.wolin.id/profile/card#me)
Features
- RFC 9449 ES256 DPoP:
generateDPoPKeyPair,computeJwkThumbprint(RFC 7638 canonical SHA-256jkt),signDPoPProof, andverifyDPoPProof(htm,htu,iat,jti,ath,nonce). - Solid-OIDC + PKCE (
S256):discoverOidcProvider,generatePkcePair,buildSolidAuthUrl,createSolidAuthRequest,exchangeCodeForTokens, andrefreshSolidTokens(including automaticuse_dpop_noncechallenge retry). - WebID & Turtle Parser:
fetchWebIdProfile,parseWebIdProfile,parseTurtle, andparseContainerTurtleextractingpim:storage,solid:oidcIssuer,ldp:inbox, andldp:contains. - Tenant
pod_idHandle Validation:isValidPodId,validatePodId,isReservedPodId, andRESERVED_POD_IDS(3..32lowercase[a-z0-9-], no leading/trailing-, no--, blocksxn--Punycode and reserved system handles). - Solid LDP CRUD, Binary Blobs & Safe
302Signed Redirects:WolinPodClient(aliased asWolinClient) withgetResource/get,getBlob,putResource,patchResource,postResource,deleteResource,createContainer,listContainer, andfetchWithDPoP— enforcingIf-Match/If-None-Match(304 Not Modified,412 Precondition FailedviaWolinPreconditionError) and strippingAuthorization/DPoPheaders when following302signed R2/CDN asset redirects.
License
MIT OR Apache-2.0 — Copyright (c) 2026 Entropy Paradox, Inc. — Wolin (月印千江)
