target-supabase-sdk 0.2.21 → 0.2.23

package/dist/shared/feed/feed.build.d.ts

@@ -3,9 +3,11 @@ import type { Link } from "../../link/link.interface";
 import { type FeedSource, type FeedValue } from "./feed.interface";
 export interface BuildFeedLinkDraftInput {
     value: FeedValue;
+    /** When set, used as Link `name` (skips {@link buildFeedLinkName}). */
+    name?: string;
     /** Dots are normalized to spaces in {@link buildFeedLinkName} before joining with `feedKey`. */
-    platformName: string;
-    feedKey: string;
+    platformName?: string;
+    feedKey?: string;
     source: FeedSource;
     locator: string;
     /**

package/dist/shared/feed/feed.build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.build.d.ts","sourceRoot":"","sources":["../../../src/shared/feed/feed.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,SAAS,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,gGAAgG;IAChG,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAcvG;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,IAAI,CAAC,CA+BpF"}
+{"version":3,"file":"feed.build.d.ts","sourceRoot":"","sources":["../../../src/shared/feed/feed.build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAGH,KAAK,UAAU,EACf,KAAK,SAAS,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAcvG;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,IAAI,CAAC,CAgCpF"}

package/dist/shared/feed/node/feed.access.d.ts

@@ -23,12 +23,20 @@ export interface FeedAvailabilityResult {
  * **Node-only**
  */
 export declare function checkFeedLocalAvailability(input: CheckFeedLocalAvailabilityInput): Promise<FeedAvailabilityResult>;
+export interface CheckFeedOssAvailabilityOptions {
+    /** Override global `fetch` (proxied outbound, etc.). Default: SDK `fetchWithRetry`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** When true, skip HTTP (co-located Files sandbox, etc.). */
+    tryLocalResolve?: (locator: string) => Promise<boolean>;
+    timeoutMs?: number;
+}
 /**
  * Remote reachability for feed ingest (`.oss` source) via HTTP(S).
  *
- * Tries `HEAD`, then `GET` with `Range: bytes=0-0` when `HEAD` is not allowed.
+ * Optional `tryLocalResolve` first (same-host Files). Then `HEAD`, then `GET` with
+ * `Range: bytes=0-0` when `HEAD` is not allowed. Pass `fetch` for proxied outbound.
  *
  * **Node-only**
  */
-export declare function checkFeedOssAvailability(locator: string): Promise<FeedAvailabilityResult>;
+export declare function checkFeedOssAvailability(locator: string, options?: CheckFeedOssAvailabilityOptions): Promise<FeedAvailabilityResult>;
 //# sourceMappingURL=feed.access.d.ts.map

package/dist/shared/feed/node/feed.access.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.access.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.access.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAoBD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAsB/F"}
+{"version":3,"file":"feed.access.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.access.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,oBAAoB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC5C,KAAK,EAAE,+BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAKD,MAAM,WAAW,+BAA+B;IAC5C,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,6DAA6D;IAC7D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,+BAA+B,GAC1C,OAAO,CAAC,sBAAsB,CAAC,CAgCjC"}

package/dist/shared/feed/node/feed.service.d.ts

@@ -1,4 +1,5 @@
-import { type FeedIngestSource } from "../feed.interface";
+import { type FeedIngestSource, type FeedValue } from "../feed.interface";
+import { type CheckFeedOssAvailabilityOptions } from "./feed.access";
 export interface RegisterFeedInput {
     /** Existing feed Link row id (must still be `.public` unless already ingested with same payload). */
     id: string;
@@ -7,6 +8,8 @@ export interface RegisterFeedInput {
     locator: string;
     /** Required when `source` is `.local` (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). Ignored for `.oss`. */
     localStorageProvider?: string;
+    /** `.oss` HTTP check: inject `fetch` / same-host resolve. */
+    ossCheck?: CheckFeedOssAvailabilityOptions;
 }
 export interface RegisterFeedResult {
     id: string;
@@ -20,4 +23,26 @@ export interface RegisterFeedResult {
  * **Node-only** — under `shared/feed/node/`; do not import from the browser entry.
  */
 export declare function registerFeed(input: RegisterFeedInput): Promise<RegisterFeedResult>;
+export interface CreateFeedInput {
+    /** Full Link `name` (Filter itemName, etc.). */
+    name: string;
+    value: FeedValue;
+    source: FeedIngestSource;
+    storageProvider: string;
+    locator: string;
+    description?: string;
+    preview?: string;
+    tagList?: string[];
+    localStorageProvider?: string;
+    ossCheck?: CheckFeedOssAvailabilityOptions;
+}
+export interface CreateFeedResult {
+    id: string;
+    created: boolean;
+}
+/**
+ * Insert a new feed Link already on `.local` or `.oss` (not a `.public` promote).
+ * Dedup: `category` + `value` + `name`. Same original → `{ created: false }`.
+ */
+export declare function createFeed(input: CreateFeedInput): Promise<CreateFeedResult>;
 //# sourceMappingURL=feed.service.d.ts.map

package/dist/shared/feed/node/feed.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.service.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EAKxB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,iBAAiB;IAC9B,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gGAAgG;IAChG,OAAO,EAAE,OAAO,CAAC;CACpB;AAmDD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+FxF"}
+{"version":3,"file":"feed.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/feed.service.ts"],"names":[],"mappings":"AAWA,OAAO,EACH,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAGjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,KAAK,+BAA+B,EAGvC,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,iBAAiB;IAC9B,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gGAAgG;IAChG,OAAO,EAAE,OAAO,CAAC;CACpB;AAmDD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+FxF;AAED,MAAM,WAAW,eAAe;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyFlF"}

package/dist/shared/feed/node/index.d.ts

@@ -4,8 +4,8 @@
  */
 export type { FeedIngestSource } from "../feed.interface";
 export { FEED_INGEST_SOURCES, isFeedIngestSource } from "../feed.interface";
-export type { CheckFeedLocalAvailabilityInput, FeedAvailabilityResult } from "./feed.access";
+export type { CheckFeedLocalAvailabilityInput, CheckFeedOssAvailabilityOptions, FeedAvailabilityResult, } from "./feed.access";
 export { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
-export type { RegisterFeedInput, RegisterFeedResult } from "./feed.service";
-export { registerFeed } from "./feed.service";
+export type { CreateFeedInput, CreateFeedResult, RegisterFeedInput, RegisterFeedResult } from "./feed.service";
+export { createFeed, registerFeed } from "./feed.service";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/feed/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/feed/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EACR,+BAA+B,EAC/B,+BAA+B,EAC/B,sBAAsB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shared/http/fetch-retry.d.ts

@@ -15,6 +15,8 @@ export interface FetchRetryOptions {
     /** When set, retry/success lines are logged via SDK logger. */
     logger?: LoggerWithScope;
     hint?: string;
+    /** Override global `fetch` (e.g. proxied outbound fetch). Ignores `dispatcher`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
 }
 export declare function fetchWithRetry(url: string, initOrFactory: RequestInit | FetchInitFactory, options: FetchRetryOptions): Promise<Response>;
 export declare function fetchBinaryWithRetry(url: string, init: RequestInit, options: FetchRetryOptions): Promise<ArrayBuffer>;

package/dist/shared/http/fetch-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-retry.d.ts","sourceRoot":"","sources":["../../../src/shared/http/fetch-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA8BD,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,WAAW,GAAG,gBAAgB,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoEnB;AAED,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAMtB"}
+{"version":3,"file":"fetch-retry.d.ts","sourceRoot":"","sources":["../../../src/shared/http/fetch-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,+DAA+D;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClE;AAuCD,wBAAsB,cAAc,CAChC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,WAAW,GAAG,gBAAgB,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAoEnB;AAED,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAMtB"}

package/dist/shared/media/node/media.service.d.ts

@@ -1,4 +1,4 @@
-import type { Link } from "../../../link/link.interface";
+import { type Link } from "../../../link/link.interface";
 import { type MediaValue } from "../media.interface";
 export interface FindMediaLinkInput {
     value: MediaValue;
@@ -13,6 +13,11 @@ export interface RegisterMediaLinkInput {
     locator: string;
     /** This host id for availability (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). */
     localStorageProvider: string;
+    /**
+     * Local file to probe when `locator` is http(s) (OSS ingest).
+     * Availability uses this path + `localStorageProvider`.
+     */
+    localLocator?: string;
     description?: string;
     tagList?: string[];
 }
@@ -22,7 +27,8 @@ export interface RegisterMediaLinkResult {
 }
 /**
  * Register a media Link: dedup → availability → probe → `postTarget`.
- * Idempotent when `category`+`value`+`name` already exist.
+ * Idempotent when `category`+`value`+`name` already exist (local path).
+ * HTTP `locator` + `localLocator`: probe local file, persist remote URL; patch if name exists.
  *
  * **Node-only** — under `shared/media/node/`; do not import from the browser entry.
  */

package/dist/shared/media/node/media.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/media/node/media.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMnE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYnF;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA4EvG"}
+{"version":3,"file":"media.service.d.ts","sourceRoot":"","sources":["../../../../src/shared/media/node/media.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,IAAI,EAAoB,MAAM,8BAA8B,CAAC;AAIzF,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMnE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAYnF;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;CACpB;AA6CD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6FvG"}

package/dist/task/task-node.d.ts

@@ -1,5 +1,6 @@
 import { BaseNodeRuntime, type NodeLoopContext } from "../node/node-runtime.base";
 import { type LoggerWithScope } from "../shared/log";
+import { type PatchClaimTaskPayload } from "./task.api";
 /**
  * Task worker node: commands → heartbeat → claim & execute tasks.
  * Built on {@link BaseNodeRuntime}.
@@ -8,6 +9,8 @@ declare class TaskNode extends BaseNodeRuntime {
     private _availableTaskList;
     private _includeRemote;
     get availableTaskList(): readonly string[];
+    /** Optional claim filters passed to {@link patchClaimTask} (e.g. name prefix per task type). */
+    protected getPatchClaimTaskOptions(): Pick<PatchClaimTaskPayload, "namePrefixList">;
     constructor();
     protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;

package/dist/task/task-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAO5F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;;cAMe,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA6KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,KAAK,qBAAqB,EAAyC,MAAM,YAAY,CAAC;AAK/F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED,gGAAgG;IAChG,SAAS,CAAC,wBAAwB,IAAI,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;;cAQnE,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA8KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/task/task.api.d.ts

@@ -127,16 +127,24 @@ export declare const patchTaskProgressSchema: z.ZodObject<{
 export type PatchTaskProgressPayload = z.infer<typeof patchTaskProgressSchema>;
 export declare const patchClaimTaskSchema: z.ZodObject<{
     nodeId: z.ZodString;
+    /** Task `value` must be in this list (always applied). */
     availableTaskList: z.ZodArray<z.ZodString, "many">;
     traceId: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional second axis on `name` (AND with `availableTaskList`, not coupled to `value`).
+     * When non-empty: `name` must equal a prefix or start with `prefix:`; query uses PostgREST `ilike`.
+     */
+    namePrefixList: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }, {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }>;
 export type PatchClaimTaskPayload = z.infer<typeof patchClaimTaskSchema>;
 export declare const patchChangeTaskStatus: (payload: {
@@ -185,7 +193,11 @@ export declare const patchTaskProgress: (payload: {
 /**
  * Discover and claim one TODO task for this node.
  *
- * Flow: oldest TODO in `availableTaskList` (FIFO by `created_at`) → {@link claimTaskById}.
+ * Match criteria (all required): `details.status = TODO`, `value ∈ availableTaskList`, and when
+ * `namePrefixList` is non-empty, `name` matches any listed prefix. Those filters are independent
+ * (AND); omitting `namePrefixList` does not relax the `value` constraint.
+ *
+ * Flow: oldest matching row (FIFO by `created_at`) → {@link claimTaskById}.
  * Equivalent to `patchChangeTaskStatus({ id, action: CLAIM, nodeId })` when `id` is already known.
  *
  * Returns `data: null` when no TODO task matches.
@@ -195,5 +207,6 @@ export declare const patchClaimTask: (payload: {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }) => SupabaseResponse<Task | null> | Promise<SupabaseResponse<Task | null>>;
 //# sourceMappingURL=task.api.d.ts.map

package/dist/task/task.api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EAA4B,KAAK,IAAI,EAAgC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0DvH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAgGzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAmGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;4EA0DzB,CAAC"}
+{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM5E,OAAO,EAA4B,KAAK,IAAI,EAAgC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0DvH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;IAE7B,0DAA0D;;;IAG1D;;;OAGG;;;;;;;;;;;;EAEL,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA0GzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAmGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;;;;;4EAkFzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "target-supabase-sdk",
-    "version": "0.2.21",
+    "version": "0.2.23",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",

package/src/node.ts

@@ -160,6 +160,9 @@ export {
 export { RepoManager } from "./repo/repo-manager";
 export type {
     CheckFeedLocalAvailabilityInput,
+    CheckFeedOssAvailabilityOptions,
+    CreateFeedInput,
+    CreateFeedResult,
     FeedAvailabilityResult,
     FeedIngestSource,
     RegisterFeedInput,
@@ -168,6 +171,7 @@ export type {
 export {
     checkFeedLocalAvailability,
     checkFeedOssAvailability,
+    createFeed,
     FEED_INGEST_SOURCES,
     isFeedIngestSource,
     registerFeed,

package/src/shared/feed/README.md

@@ -36,7 +36,7 @@ import {
 } from "target-supabase-sdk";
 
 // Node — ingest after .public draft exists
-import { registerFeed, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
+import { registerFeed, createFeed, checkFeedOssAvailability, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
 ```
 
 ---
@@ -45,6 +45,7 @@ import { registerFeed, FEED_INGEST_SOURCES } from "target-supabase-sdk/node";
 
 1. **Create (browser or any host)** — `buildFeedLinkDraft` with `source: ".public"`, public `locator` (often a platform URL), `original.storageProvider: ""`. Persist via `postTarget` / `createTarget`.
 2. **Ingest (Node)** — `registerFeed` on an existing row `id`: validate the new locator, then promote `tagList` from `.public` to `.local` or `.oss` and update `original.storageProvider` + `locator`. Preserves `twinList` and other non-source tags.
+3. **Create already ingested (Node)** — `createFeed` inserts a new row already tagged `.local` or `.oss` (Filter / OSS-first). Dedup on `category` + `value` + `name`.
 
 ---
 
@@ -108,7 +109,7 @@ Leading `.` marks **system** tags (not user tags).
 3. Require `tagList` to include `.public` (not already ingested with different state).
 4. **Availability**
    - `.local` — `checkFeedLocalAvailability`: `storageProvider === localStorageProvider`, absolute path, file (or directory for `feed.image-list`) exists and is non-empty where applicable.
-   - `.oss` — `checkFeedOssAvailability`: `http(s)` URL; `HEAD`, then `GET` with `Range: bytes=0-0` if `HEAD` is not supported.
+   - `.oss` — `checkFeedOssAvailability`: `http(s)` URL; optional `tryLocalResolve` then `HEAD`, then `GET` with `Range: bytes=0-0` if `HEAD` is not supported. Pass `ossCheck.fetch` for proxied outbound.
 5. **Update** — `updateTarget` with optimistic lock `details->original->>storageProvider` eq `""` (still `.public` tier). Sets `tagList` via `buildFeedTagList`, updates `original.storageProvider` and `locator`, keeps `twinList`.
 
 **Errors (representative)**
@@ -149,7 +150,7 @@ Same variable as media register — see `src/shared/media/README.md`.
 
 | Topic | Current behavior | Possible follow-up |
 |-------|------------------|-------------------|
-| OSS auth | Only anonymous `HEAD`/`GET` | Signed URLs or provider-specific probes |
+| OSS HTTP | Default global `fetch`; inject `fetch` / `tryLocalResolve` | Signed URLs or provider-specific probes |
 | `.local` on another host | Fails availability (by design, like media) | Remote agent ingest |
 | `twinList` on ingest | Not re-validated | Optional probe per twin |
 | Re-ingest / migrate `.local` → `.oss` | Not supported | New API with lock on prior source tag |

package/src/shared/feed/feed.build.ts

@@ -13,9 +13,11 @@ import { buildFeedLinkName } from "./feed.name";
 
 export interface BuildFeedLinkDraftInput {
     value: FeedValue;
+    /** When set, used as Link `name` (skips {@link buildFeedLinkName}). */
+    name?: string;
     /** Dots are normalized to spaces in {@link buildFeedLinkName} before joining with `feedKey`. */
-    platformName: string;
-    feedKey: string;
+    platformName?: string;
+    feedKey?: string;
     source: FeedSource;
     locator: string;
     /**
@@ -75,7 +77,8 @@ export function buildFeedLinkDraft(input: BuildFeedLinkDraftInput): TargetDraft<
         throw new Error(`buildFeedLinkDraft: unsupported feed source: ${String(input.source)}`);
     }
 
-    const name = buildFeedLinkName(input.platformName, input.feedKey);
+    const explicitName = input.name?.trim() ?? "";
+    const name = explicitName !== "" ? explicitName : buildFeedLinkName(input.platformName ?? "", input.feedKey ?? "");
     const locator = input.locator.trim();
     if (locator === "") {
         throw new Error("buildFeedLinkDraft: locator is empty");

package/src/shared/feed/node/feed.access.ts

@@ -87,7 +87,19 @@ export async function checkFeedLocalAvailability(
 const OSS_CHECK_TIMEOUT_MS = 15_000;
 const OSS_CHECK_MAX_ATTEMPTS = 2;
 
-async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promise<Response> {
+export interface CheckFeedOssAvailabilityOptions {
+    /** Override global `fetch` (proxied outbound, etc.). Default: SDK `fetchWithRetry`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** When true, skip HTTP (co-located Files sandbox, etc.). */
+    tryLocalResolve?: (locator: string) => Promise<boolean>;
+    timeoutMs?: number;
+}
+
+async function probeHttpLocator(
+    locator: string,
+    method: "HEAD" | "GET",
+    options?: CheckFeedOssAvailabilityOptions,
+): Promise<Response> {
     return fetchWithRetry(
         locator,
         {
@@ -96,8 +108,9 @@ async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promis
         },
         {
             label: "feed-oss-check",
-            timeoutMs: OSS_CHECK_TIMEOUT_MS,
+            timeoutMs: options?.timeoutMs ?? OSS_CHECK_TIMEOUT_MS,
             maxAttempts: OSS_CHECK_MAX_ATTEMPTS,
+            ...(options?.fetch != null ? { fetch: options.fetch } : {}),
         },
     );
 }
@@ -105,11 +118,15 @@ async function probeHttpLocator(locator: string, method: "HEAD" | "GET"): Promis
 /**
  * Remote reachability for feed ingest (`.oss` source) via HTTP(S).
  *
- * Tries `HEAD`, then `GET` with `Range: bytes=0-0` when `HEAD` is not allowed.
+ * Optional `tryLocalResolve` first (same-host Files). Then `HEAD`, then `GET` with
+ * `Range: bytes=0-0` when `HEAD` is not allowed. Pass `fetch` for proxied outbound.
  *
  * **Node-only**
  */
-export async function checkFeedOssAvailability(locator: string): Promise<FeedAvailabilityResult> {
+export async function checkFeedOssAvailability(
+    locator: string,
+    options?: CheckFeedOssAvailabilityOptions,
+): Promise<FeedAvailabilityResult> {
     const trimmed = locator.trim();
     if (trimmed === "") {
         return { ok: false, reason: "locator is empty" };
@@ -118,10 +135,20 @@ export async function checkFeedOssAvailability(locator: string): Promise<FeedAva
         return { ok: false, reason: `oss locator must be an http(s) URL: ${trimmed}` };
     }
 
+    if (options?.tryLocalResolve != null) {
+        try {
+            if (await options.tryLocalResolve(trimmed)) {
+                return { ok: true };
+            }
+        } catch {
+            // fall through to HTTP
+        }
+    }
+
     try {
-        let response = await probeHttpLocator(trimmed, "HEAD");
+        let response = await probeHttpLocator(trimmed, "HEAD", options);
         if (response.status === 405 || response.status === 501) {
-            response = await probeHttpLocator(trimmed, "GET");
+            response = await probeHttpLocator(trimmed, "GET", options);
         }
         if (response.ok || (response.status >= 200 && response.status < 400)) {
             return { ok: true };

package/src/shared/feed/node/feed.service.ts

@@ -1,8 +1,14 @@
-import { getTarget, updateTarget } from "../../../core.api";
+import {
+    getPossibleTarget,
+    getTarget,
+    isCreateTargetAlreadyExistsError,
+    postTarget,
+    updateTarget,
+} from "../../../core.api";
 import type { Target } from "../../../core.interface";
 import { CategoryLink, type Link, type LinkDetails } from "../../../link/link.interface";
 import { createLogger } from "../../log/core/create-logger";
-import { buildFeedTagList, resolveFeedOriginalStorageProvider } from "../feed.build";
+import { buildFeedLinkDraft, buildFeedTagList, resolveFeedOriginalStorageProvider } from "../feed.build";
 import {
     type FeedIngestSource,
     type FeedOriginal,
@@ -10,7 +16,12 @@ import {
     isFeedIngestSource,
     isFeedValue,
 } from "../feed.interface";
-import { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
+import { feedLinkDedupFilters } from "../feed.query";
+import {
+    type CheckFeedOssAvailabilityOptions,
+    checkFeedLocalAvailability,
+    checkFeedOssAvailability,
+} from "./feed.access";
 
 const logger = createLogger({ module: "feed" });
 
@@ -22,6 +33,8 @@ export interface RegisterFeedInput {
     locator: string;
     /** Required when `source` is `.local` (e.g. `process.env.LOCAL_STORAGE_PROVIDER`). Ignored for `.oss`. */
     localStorageProvider?: string;
+    /** `.oss` HTTP check: inject `fetch` / same-host resolve. */
+    ossCheck?: CheckFeedOssAvailabilityOptions;
 }
 
 export interface RegisterFeedResult {
@@ -137,7 +150,7 @@ export async function registerFeed(input: RegisterFeedInput): Promise<RegisterFe
             throw new Error(`registerFeed: local locator unavailable — ${availability.reason ?? "unknown"}`);
         }
     } else {
-        const availability = await checkFeedOssAvailability(locator);
+        const availability = await checkFeedOssAvailability(locator, input.ossCheck);
         if (!availability.ok) {
             throw new Error(`registerFeed: oss locator unavailable — ${availability.reason ?? "unknown"}`);
         }
@@ -181,3 +194,117 @@ export async function registerFeed(input: RegisterFeedInput): Promise<RegisterFe
     });
     return { id, updated: true };
 }
+
+export interface CreateFeedInput {
+    /** Full Link `name` (Filter itemName, etc.). */
+    name: string;
+    value: FeedValue;
+    source: FeedIngestSource;
+    storageProvider: string;
+    locator: string;
+    description?: string;
+    preview?: string;
+    tagList?: string[];
+    localStorageProvider?: string;
+    ossCheck?: CheckFeedOssAvailabilityOptions;
+}
+
+export interface CreateFeedResult {
+    id: string;
+    created: boolean;
+}
+
+/**
+ * Insert a new feed Link already on `.local` or `.oss` (not a `.public` promote).
+ * Dedup: `category` + `value` + `name`. Same original → `{ created: false }`.
+ */
+export async function createFeed(input: CreateFeedInput): Promise<CreateFeedResult> {
+    if (!isFeedValue(input.value)) {
+        throw new Error(`createFeed: unsupported feed value: ${String(input.value)}`);
+    }
+    if (!isFeedIngestSource(input.source)) {
+        throw new Error(`createFeed: source must be .local or .oss, got ${String(input.source)}`);
+    }
+
+    const name = input.name.trim();
+    if (name === "") {
+        throw new Error("createFeed: name is empty");
+    }
+
+    const resolvedStorageProvider = resolveFeedOriginalStorageProvider(input.source, input.storageProvider);
+    const locator = input.locator.trim();
+    if (locator === "") {
+        throw new Error("createFeed: locator is empty");
+    }
+
+    const { data: existing } = await getPossibleTarget({
+        filterList: feedLinkDedupFilters({ value: input.value, name }),
+    });
+    if (existing != null) {
+        const link = existing as Link;
+        if (isSameIngestState(link, input.source, resolvedStorageProvider, locator)) {
+            return { id: existing.id, created: false };
+        }
+        throw new Error("createFeed: feed name already exists with different source, storageProvider, or locator");
+    }
+
+    if (input.source === ".local") {
+        const localStorageProvider = input.localStorageProvider?.trim() ?? "";
+        if (localStorageProvider === "") {
+            throw new Error("createFeed: localStorageProvider is required when source is .local");
+        }
+        const availability = await checkFeedLocalAvailability({
+            value: input.value,
+            storageProvider: resolvedStorageProvider,
+            locator,
+            localStorageProvider,
+        });
+        if (!availability.ok) {
+            throw new Error(`createFeed: local locator unavailable — ${availability.reason ?? "unknown"}`);
+        }
+    } else {
+        const availability = await checkFeedOssAvailability(locator, input.ossCheck);
+        if (!availability.ok) {
+            throw new Error(`createFeed: oss locator unavailable — ${availability.reason ?? "unknown"}`);
+        }
+    }
+
+    const draft = buildFeedLinkDraft({
+        name,
+        value: input.value,
+        source: input.source,
+        storageProvider: resolvedStorageProvider,
+        locator,
+        description: input.description,
+        preview: input.preview ?? locator,
+        tagList: input.tagList,
+    });
+
+    try {
+        const { data, error } = await postTarget({
+            name: draft.name,
+            value: draft.value,
+            category: draft.category,
+            tagList: draft.tagList,
+            details: draft.details,
+        });
+        if (error != null || data == null) {
+            throw new Error(error?.message ?? "createFeed: postTarget failed");
+        }
+        logger.info("feed created", {
+            topic: "register",
+            data: { id: data.id, source: input.source, name, locator },
+        });
+        return { id: data.id, created: true };
+    } catch (error) {
+        if (isCreateTargetAlreadyExistsError(error)) {
+            const raced = await getPossibleTarget({
+                filterList: feedLinkDedupFilters({ value: input.value, name }),
+            });
+            if (raced.data != null) {
+                return { id: raced.data.id, created: false };
+            }
+        }
+        throw error;
+    }
+}

package/src/shared/feed/node/index.ts

@@ -5,7 +5,11 @@
 
 export type { FeedIngestSource } from "../feed.interface";
 export { FEED_INGEST_SOURCES, isFeedIngestSource } from "../feed.interface";
-export type { CheckFeedLocalAvailabilityInput, FeedAvailabilityResult } from "./feed.access";
+export type {
+    CheckFeedLocalAvailabilityInput,
+    CheckFeedOssAvailabilityOptions,
+    FeedAvailabilityResult,
+} from "./feed.access";
 export { checkFeedLocalAvailability, checkFeedOssAvailability } from "./feed.access";
-export type { RegisterFeedInput, RegisterFeedResult } from "./feed.service";
-export { registerFeed } from "./feed.service";
+export type { CreateFeedInput, CreateFeedResult, RegisterFeedInput, RegisterFeedResult } from "./feed.service";
+export { createFeed, registerFeed } from "./feed.service";

package/src/shared/http/fetch-retry.ts

@@ -28,6 +28,8 @@ export interface FetchRetryOptions {
     /** When set, retry/success lines are logged via SDK logger. */
     logger?: LoggerWithScope;
     hint?: string;
+    /** Override global `fetch` (e.g. proxied outbound fetch). Ignores `dispatcher`. */
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
 }
 
 function backoffMs(retryBaseMs: number, attempt: number, response?: Response, maxBackoffMs?: number): number {
@@ -47,11 +49,20 @@ function backoffMs(retryBaseMs: number, attempt: number, response?: Response, ma
     return delayMs;
 }
 
-async function fetchOnce(url: string, init: RequestInit, timeoutMs: number, dispatcher?: unknown): Promise<Response> {
+async function fetchOnce(
+    url: string,
+    init: RequestInit,
+    timeoutMs: number,
+    dispatcher?: unknown,
+    fetchImpl?: (url: string, init?: RequestInit) => Promise<Response>,
+): Promise<Response> {
     const options: RequestInit & { dispatcher?: unknown } = {
         ...init,
         signal: AbortSignal.timeout(timeoutMs),
     };
+    if (fetchImpl != null) {
+        return fetchImpl(url, options);
+    }
     if (dispatcher != null) {
         options.dispatcher = dispatcher;
     }
@@ -76,7 +87,7 @@ export async function fetchWithRetry(
 
     for (let attempt = 1; attempt <= maxAttempts; attempt++) {
         try {
-            const response = await fetchOnce(url, buildInit(), options.timeoutMs, options.dispatcher);
+            const response = await fetchOnce(url, buildInit(), options.timeoutMs, options.dispatcher, options.fetch);
 
             if (!response.ok && isRetryableStatus(response.status) && attempt < maxAttempts) {
                 const delayMs = backoffMs(retryBaseMs, attempt, response, options.maxBackoffMs);