@bitbitpress/client 2.0.0-beta.6 → 2.0.0-beta.7

package/README.md

@@ -764,7 +764,7 @@ Data methods require authentication. Call `client.user.authenticate()` before us
 
 #### assets
 
-Fetch assets by internal IDs or external IDs, and return requested fields.
+Fetch assets by internal IDs, external IDs, or source URLs, and return requested fields.
 
 ```typescript
 client.data.assets(options: AssetsRequest): Promise<AssetsResponse>
@@ -772,8 +772,11 @@ client.data.assets(options: AssetsRequest): Promise<AssetsResponse>
 
 ##### Parameters
 
-- `options.assetIds` (required unless `externalIds` is provided): List of BitBitPress asset IDs to fetch
-- `options.externalIds` (required unless `assetIds` is provided): List of source-system external IDs to fetch
+Provide exactly one of `assetIds`, `externalIds`, or `sourceUrls`.
+
+- `options.assetIds`: List of BitBitPress asset IDs to fetch
+- `options.externalIds`: List of source-system external IDs to fetch
+- `options.sourceUrls`: List of canonical source URLs (article permalinks) to resolve to assets
 - `options.assetFields` (required): Asset fields to return (dot or bracket notation, e.g. `tags[0]`, `images[1].src`). Allowed: `assetId`, `title`, `tags`, `images`, `videos`, `audios`, `publishedAt`, `externalId`, `externalData`, `assetType`, `sourceUrl`, `dataSource.name`, and subfields. Empty array returns objects with only `assetId`.
 
 ##### Returns
@@ -791,6 +794,12 @@ const { assets } = await client.data.assets({
 });
 
 console.log('Assets:', assets);
+
+// Resolve assets by their public URL (e.g. a link in article content)
+const { assets: linked } = await client.data.assets({
+  sourceUrls: ['https://example.com/some-article/'],
+  assetFields: ['assetId', 'title'],
+});
 ```
 
 ---
@@ -995,10 +1004,12 @@ Request body for POST `/v1/data/assets`.
 type AssetsRequest = {
   assetIds?: string[];
   externalIds?: string[];
+  sourceUrls?: string[];
   assetFields: string[];
 } & (
-  | { assetIds: string[]; externalIds?: string[] }
-  | { assetIds?: string[]; externalIds: string[] }
+  | { assetIds: string[]; externalIds?: string[]; sourceUrls?: string[] }
+  | { assetIds?: string[]; externalIds: string[]; sourceUrls?: string[] }
+  | { assetIds?: string[]; externalIds?: string[]; sourceUrls: string[] }
 );
 ```
 

package/dist/data/assets.d.ts

@@ -4,9 +4,15 @@ type OpenApiAssetsRequest = paths['/v1/data/assets']['post']['requestBody']['con
 export type AssetsRequest = OpenApiAssetsRequest & ({
     assetIds: string[];
     externalIds?: string[];
+    sourceUrls?: string[];
 } | {
     assetIds?: string[];
     externalIds: string[];
+    sourceUrls?: string[];
+} | {
+    assetIds?: string[];
+    externalIds?: string[];
+    sourceUrls: string[];
 });
 export type AssetsResponse = paths['/v1/data/assets']['post']['responses'][200]['content']['application/json']['data'];
 /**

package/dist/data/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,oBAAoB,GACvB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAC9C,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,cAAc,GACxB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,KAAK,oBAAoB,GACvB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAC9C,CACI;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE;IAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CACxE,CAAC;AAEJ,MAAM,MAAM,cAAc,GACxB,KAAK,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;;;;;GAMG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/data/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":";;AAoBA,wBAeC;AAjCD,8CAA4C;AAW5C;;;;;;GAMG;AACI,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAiB,MAAM,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/data/assets.ts"],"names":[],"mappings":";;AAwBA,wBAeC;AArCD,8CAA4C;AAe5C;;;;;;GAMG;AACI,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,OAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,IAAA,wBAAW,EAAiB,MAAM,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/generated/openapi.d.ts

@@ -2393,6 +2393,8 @@ export interface paths {
                         assetIds?: string[];
                         /** @description List of external IDs to fetch */
                         externalIds?: string[];
+                        /** @description List of source URLs (article permalinks) to resolve to assets */
+                        sourceUrls?: string[];
                         /** @description Asset fields to return (dot or bracket notation). Allowed: assetId, title, tags, images, videos, publishedAt, externalId, externalData, assetType, sourceUrl, dataSource.name, and subfields. Empty array returns objects with only assetId. */
                         assetFields: string[];
                     } & (unknown | unknown);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbitpress/client",
-  "version": "2.0.0-beta.6",
+  "version": "2.0.0-beta.7",
   "description": "BitBitPress TypeScript client library",
   "type": "module",
   "main": "./dist/index.js",